2 * S5P/EXYNOS4 SoC series camera host interface media device driver
4 * Copyright (C) 2011 - 2013 Samsung Electronics Co., Ltd.
5 * Author: Sylwester Nawrocki <s.nawrocki@samsung.com>
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published
9 * by the Free Software Foundation, either version 2 of the License,
10 * or (at your option) any later version.
13 #include <linux/bug.h>
14 #include <linux/clk.h>
15 #include <linux/clk-provider.h>
16 #include <linux/device.h>
17 #include <linux/errno.h>
18 #include <linux/i2c.h>
19 #include <linux/kernel.h>
20 #include <linux/list.h>
21 #include <linux/module.h>
23 #include <linux/of_platform.h>
24 #include <linux/of_device.h>
25 #include <linux/of_graph.h>
26 #include <linux/platform_device.h>
27 #include <linux/pm_runtime.h>
28 #include <linux/types.h>
29 #include <linux/slab.h>
30 #include <media/v4l2-async.h>
31 #include <media/v4l2-ctrls.h>
32 #include <media/v4l2-of.h>
33 #include <media/media-device.h>
34 #include <media/exynos-fimc.h>
36 #include "media-dev.h"
37 #include "fimc-core.h"
39 #include "fimc-lite.h"
40 #include "mipi-csis.h"
42 /* Set up image sensor subdev -> FIMC capture node notifications. */
43 static void __setup_sensor_notification(struct fimc_md *fmd,
44 struct v4l2_subdev *sensor,
45 struct v4l2_subdev *fimc_sd)
47 struct fimc_source_info *src_inf;
48 struct fimc_sensor_info *md_si;
51 src_inf = v4l2_get_subdev_hostdata(sensor);
52 if (!src_inf || WARN_ON(fmd == NULL))
55 md_si = source_to_sensor_info(src_inf);
56 spin_lock_irqsave(&fmd->slock, flags);
57 md_si->host = v4l2_get_subdevdata(fimc_sd);
58 spin_unlock_irqrestore(&fmd->slock, flags);
62 * fimc_pipeline_prepare - update pipeline information with subdevice pointers
63 * @me: media entity terminating the pipeline
65 * Caller holds the graph mutex.
67 static void fimc_pipeline_prepare(struct fimc_pipeline *p,
68 struct media_entity *me)
70 struct fimc_md *fmd = entity_to_fimc_mdev(me);
71 struct v4l2_subdev *sd;
72 struct v4l2_subdev *sensor = NULL;
75 for (i = 0; i < IDX_MAX; i++)
79 struct media_pad *pad = NULL;
81 /* Find remote source pad */
82 for (i = 0; i < me->num_pads; i++) {
83 struct media_pad *spad = &me->pads[i];
84 if (!(spad->flags & MEDIA_PAD_FL_SINK))
86 pad = media_entity_remote_pad(spad);
92 media_entity_type(pad->entity) != MEDIA_ENT_T_V4L2_SUBDEV)
94 sd = media_entity_to_v4l2_subdev(pad->entity);
100 case GRP_ID_FIMC_IS_SENSOR:
101 p->subdevs[IDX_SENSOR] = sd;
104 p->subdevs[IDX_CSIS] = sd;
107 p->subdevs[IDX_FLITE] = sd;
110 p->subdevs[IDX_FIMC] = sd;
113 p->subdevs[IDX_IS_ISP] = sd;
119 if (me->num_pads == 1)
123 if (sensor && p->subdevs[IDX_FIMC])
124 __setup_sensor_notification(fmd, sensor, p->subdevs[IDX_FIMC]);
128 * __subdev_set_power - change power state of a single subdev
129 * @sd: subdevice to change power state for
130 * @on: 1 to enable power or 0 to disable
132 * Return result of s_power subdev operation or -ENXIO if sd argument
133 * is NULL. Return 0 if the subdevice does not implement s_power.
135 static int __subdev_set_power(struct v4l2_subdev *sd, int on)
143 use_count = &sd->entity.use_count;
144 if (on && (*use_count)++ > 0)
146 else if (!on && (*use_count == 0 || --(*use_count) > 0))
148 ret = v4l2_subdev_call(sd, core, s_power, on);
150 return ret != -ENOIOCTLCMD ? ret : 0;
154 * fimc_pipeline_s_power - change power state of all pipeline subdevs
155 * @fimc: fimc device terminating the pipeline
156 * @state: true to power on, false to power off
158 * Needs to be called with the graph mutex held.
160 static int fimc_pipeline_s_power(struct fimc_pipeline *p, bool on)
162 static const u8 seq[2][IDX_MAX - 1] = {
163 { IDX_IS_ISP, IDX_SENSOR, IDX_CSIS, IDX_FLITE },
164 { IDX_CSIS, IDX_FLITE, IDX_SENSOR, IDX_IS_ISP },
168 if (p->subdevs[IDX_SENSOR] == NULL)
171 for (i = 0; i < IDX_MAX - 1; i++) {
172 unsigned int idx = seq[on][i];
174 ret = __subdev_set_power(p->subdevs[idx], on);
177 if (ret < 0 && ret != -ENXIO)
182 for (; i >= 0; i--) {
183 unsigned int idx = seq[on][i];
184 __subdev_set_power(p->subdevs[idx], !on);
190 * __fimc_pipeline_open - update the pipeline information, enable power
191 * of all pipeline subdevs and the sensor clock
192 * @me: media entity to start graph walk with
193 * @prepare: true to walk the current pipeline and acquire all subdevs
195 * Called with the graph mutex held.
197 static int __fimc_pipeline_open(struct exynos_media_pipeline *ep,
198 struct media_entity *me, bool prepare)
200 struct fimc_md *fmd = entity_to_fimc_mdev(me);
201 struct fimc_pipeline *p = to_fimc_pipeline(ep);
202 struct v4l2_subdev *sd;
205 if (WARN_ON(p == NULL || me == NULL))
209 fimc_pipeline_prepare(p, me);
211 sd = p->subdevs[IDX_SENSOR];
215 /* Disable PXLASYNC clock if this pipeline includes FIMC-IS */
216 if (!IS_ERR(fmd->wbclk[CLK_IDX_WB_B]) && p->subdevs[IDX_IS_ISP]) {
217 ret = clk_prepare_enable(fmd->wbclk[CLK_IDX_WB_B]);
222 ret = fimc_pipeline_s_power(p, 1);
226 if (!IS_ERR(fmd->wbclk[CLK_IDX_WB_B]) && p->subdevs[IDX_IS_ISP])
227 clk_disable_unprepare(fmd->wbclk[CLK_IDX_WB_B]);
233 * __fimc_pipeline_close - disable the sensor clock and pipeline power
234 * @fimc: fimc device terminating the pipeline
236 * Disable power of all subdevs and turn the external sensor clock off.
238 static int __fimc_pipeline_close(struct exynos_media_pipeline *ep)
240 struct fimc_pipeline *p = to_fimc_pipeline(ep);
241 struct v4l2_subdev *sd = p ? p->subdevs[IDX_SENSOR] : NULL;
246 pr_warn("%s(): No sensor subdev\n", __func__);
250 ret = fimc_pipeline_s_power(p, 0);
252 fmd = entity_to_fimc_mdev(&sd->entity);
254 /* Disable PXLASYNC clock if this pipeline includes FIMC-IS */
255 if (!IS_ERR(fmd->wbclk[CLK_IDX_WB_B]) && p->subdevs[IDX_IS_ISP])
256 clk_disable_unprepare(fmd->wbclk[CLK_IDX_WB_B]);
258 return ret == -ENXIO ? 0 : ret;
262 * __fimc_pipeline_s_stream - call s_stream() on pipeline subdevs
263 * @pipeline: video pipeline structure
264 * @on: passed as the s_stream() callback argument
266 static int __fimc_pipeline_s_stream(struct exynos_media_pipeline *ep, bool on)
268 static const u8 seq[2][IDX_MAX] = {
269 { IDX_FIMC, IDX_SENSOR, IDX_IS_ISP, IDX_CSIS, IDX_FLITE },
270 { IDX_CSIS, IDX_FLITE, IDX_FIMC, IDX_SENSOR, IDX_IS_ISP },
272 struct fimc_pipeline *p = to_fimc_pipeline(ep);
275 if (p->subdevs[IDX_SENSOR] == NULL)
278 for (i = 0; i < IDX_MAX; i++) {
279 unsigned int idx = seq[on][i];
281 ret = v4l2_subdev_call(p->subdevs[idx], video, s_stream, on);
283 if (ret < 0 && ret != -ENOIOCTLCMD && ret != -ENODEV)
288 for (; i >= 0; i--) {
289 unsigned int idx = seq[on][i];
290 v4l2_subdev_call(p->subdevs[idx], video, s_stream, !on);
295 /* Media pipeline operations for the FIMC/FIMC-LITE video device driver */
296 static const struct exynos_media_pipeline_ops fimc_pipeline_ops = {
297 .open = __fimc_pipeline_open,
298 .close = __fimc_pipeline_close,
299 .set_stream = __fimc_pipeline_s_stream,
302 static struct exynos_media_pipeline *fimc_md_pipeline_create(
305 struct fimc_pipeline *p;
307 p = kzalloc(sizeof(*p), GFP_KERNEL);
311 list_add_tail(&p->list, &fmd->pipelines);
313 p->ep.ops = &fimc_pipeline_ops;
317 static void fimc_md_pipelines_free(struct fimc_md *fmd)
319 while (!list_empty(&fmd->pipelines)) {
320 struct fimc_pipeline *p;
322 p = list_entry(fmd->pipelines.next, typeof(*p), list);
328 /* Parse port node and register as a sub-device any sensor specified there. */
329 static int fimc_md_parse_port_node(struct fimc_md *fmd,
330 struct device_node *port,
333 struct fimc_source_info *pd = &fmd->sensor[index].pdata;
334 struct device_node *rem, *ep, *np;
335 struct v4l2_of_endpoint endpoint;
337 /* Assume here a port node can have only one endpoint node. */
338 ep = of_get_next_child(port, NULL);
342 v4l2_of_parse_endpoint(ep, &endpoint);
343 if (WARN_ON(endpoint.base.port == 0) || index >= FIMC_MAX_SENSORS)
346 pd->mux_id = (endpoint.base.port - 1) & 0x1;
348 rem = of_graph_get_remote_port_parent(ep);
351 v4l2_info(&fmd->v4l2_dev, "Remote device at %s not found\n",
356 if (fimc_input_is_parallel(endpoint.base.port)) {
357 if (endpoint.bus_type == V4L2_MBUS_PARALLEL)
358 pd->sensor_bus_type = FIMC_BUS_TYPE_ITU_601;
360 pd->sensor_bus_type = FIMC_BUS_TYPE_ITU_656;
361 pd->flags = endpoint.bus.parallel.flags;
362 } else if (fimc_input_is_mipi_csi(endpoint.base.port)) {
364 * MIPI CSI-2: only input mux selection and
365 * the sensor's clock frequency is needed.
367 pd->sensor_bus_type = FIMC_BUS_TYPE_MIPI_CSI2;
369 v4l2_err(&fmd->v4l2_dev, "Wrong port id (%u) at node %s\n",
370 endpoint.base.port, rem->full_name);
373 * For FIMC-IS handled sensors, that are placed under i2c-isp device
374 * node, FIMC is connected to the FIMC-IS through its ISP Writeback
375 * input. Sensors are attached to the FIMC-LITE hostdata interface
376 * directly or through MIPI-CSIS, depending on the external media bus
377 * used. This needs to be handled in a more reliable way, not by just
378 * checking parent's node name.
380 np = of_get_parent(rem);
382 if (np && !of_node_cmp(np->name, "i2c-isp"))
383 pd->fimc_bus_type = FIMC_BUS_TYPE_ISP_WRITEBACK;
385 pd->fimc_bus_type = pd->sensor_bus_type;
387 if (WARN_ON(index >= ARRAY_SIZE(fmd->sensor)))
390 fmd->sensor[index].asd.match_type = V4L2_ASYNC_MATCH_OF;
391 fmd->sensor[index].asd.match.of.node = rem;
392 fmd->async_subdevs[index] = &fmd->sensor[index].asd;
400 /* Register all SoC external sub-devices */
401 static int fimc_md_register_sensor_entities(struct fimc_md *fmd)
403 struct device_node *parent = fmd->pdev->dev.of_node;
404 struct device_node *node, *ports;
409 * Runtime resume one of the FIMC entities to make sure
410 * the sclk_cam clocks are not globally disabled.
415 ret = pm_runtime_get_sync(fmd->pmf);
419 fmd->num_sensors = 0;
421 /* Attach sensors linked to MIPI CSI-2 receivers */
422 for_each_available_child_of_node(parent, node) {
423 struct device_node *port;
425 if (of_node_cmp(node->name, "csis"))
427 /* The csis node can have only port subnode. */
428 port = of_get_next_child(node, NULL);
432 ret = fimc_md_parse_port_node(fmd, port, index);
438 /* Attach sensors listed in the parallel-ports node */
439 ports = of_get_child_by_name(parent, "parallel-ports");
443 for_each_child_of_node(ports, node) {
444 ret = fimc_md_parse_port_node(fmd, node, index);
450 pm_runtime_put(fmd->pmf);
454 static int __of_get_csis_id(struct device_node *np)
458 np = of_get_child_by_name(np, "port");
461 of_property_read_u32(np, "reg", ®);
462 return reg - FIMC_INPUT_MIPI_CSI2_0;
466 * MIPI-CSIS, FIMC and FIMC-LITE platform devices registration.
468 static int register_fimc_lite_entity(struct fimc_md *fmd,
469 struct fimc_lite *fimc_lite)
471 struct v4l2_subdev *sd;
472 struct exynos_media_pipeline *ep;
475 if (WARN_ON(fimc_lite->index >= FIMC_LITE_MAX_DEVS ||
476 fmd->fimc_lite[fimc_lite->index]))
479 sd = &fimc_lite->subdev;
480 sd->grp_id = GRP_ID_FLITE;
482 ep = fimc_md_pipeline_create(fmd);
486 v4l2_set_subdev_hostdata(sd, ep);
488 ret = v4l2_device_register_subdev(&fmd->v4l2_dev, sd);
490 fmd->fimc_lite[fimc_lite->index] = fimc_lite;
492 v4l2_err(&fmd->v4l2_dev, "Failed to register FIMC.LITE%d\n",
497 static int register_fimc_entity(struct fimc_md *fmd, struct fimc_dev *fimc)
499 struct v4l2_subdev *sd;
500 struct exynos_media_pipeline *ep;
503 if (WARN_ON(fimc->id >= FIMC_MAX_DEVS || fmd->fimc[fimc->id]))
506 sd = &fimc->vid_cap.subdev;
507 sd->grp_id = GRP_ID_FIMC;
509 ep = fimc_md_pipeline_create(fmd);
513 v4l2_set_subdev_hostdata(sd, ep);
515 ret = v4l2_device_register_subdev(&fmd->v4l2_dev, sd);
517 if (!fmd->pmf && fimc->pdev)
518 fmd->pmf = &fimc->pdev->dev;
519 fmd->fimc[fimc->id] = fimc;
520 fimc->vid_cap.user_subdev_api = fmd->user_subdev_api;
522 v4l2_err(&fmd->v4l2_dev, "Failed to register FIMC.%d (%d)\n",
528 static int register_csis_entity(struct fimc_md *fmd,
529 struct platform_device *pdev,
530 struct v4l2_subdev *sd)
532 struct device_node *node = pdev->dev.of_node;
535 id = node ? __of_get_csis_id(node) : max(0, pdev->id);
537 if (WARN_ON(id < 0 || id >= CSIS_MAX_ENTITIES))
540 if (WARN_ON(fmd->csis[id].sd))
543 sd->grp_id = GRP_ID_CSIS;
544 ret = v4l2_device_register_subdev(&fmd->v4l2_dev, sd);
546 fmd->csis[id].sd = sd;
548 v4l2_err(&fmd->v4l2_dev,
549 "Failed to register MIPI-CSIS.%d (%d)\n", id, ret);
553 static int register_fimc_is_entity(struct fimc_md *fmd, struct fimc_is *is)
555 struct v4l2_subdev *sd = &is->isp.subdev;
556 struct exynos_media_pipeline *ep;
559 /* Allocate pipeline object for the ISP capture video node. */
560 ep = fimc_md_pipeline_create(fmd);
564 v4l2_set_subdev_hostdata(sd, ep);
566 ret = v4l2_device_register_subdev(&fmd->v4l2_dev, sd);
568 v4l2_err(&fmd->v4l2_dev,
569 "Failed to register FIMC-ISP (%d)\n", ret);
577 static int fimc_md_register_platform_entity(struct fimc_md *fmd,
578 struct platform_device *pdev,
581 struct device *dev = &pdev->dev;
582 int ret = -EPROBE_DEFER;
585 /* Lock to ensure dev->driver won't change. */
588 if (!dev->driver || !try_module_get(dev->driver->owner))
591 drvdata = dev_get_drvdata(dev);
592 /* Some subdev didn't probe successfully id drvdata is NULL */
594 switch (plat_entity) {
596 ret = register_fimc_entity(fmd, drvdata);
599 ret = register_fimc_lite_entity(fmd, drvdata);
602 ret = register_csis_entity(fmd, pdev, drvdata);
605 ret = register_fimc_is_entity(fmd, drvdata);
612 module_put(dev->driver->owner);
615 if (ret == -EPROBE_DEFER)
616 dev_info(&fmd->pdev->dev, "deferring %s device registration\n",
619 dev_err(&fmd->pdev->dev, "%s device registration failed (%d)\n",
624 /* Register FIMC, FIMC-LITE and CSIS media entities */
625 static int fimc_md_register_platform_entities(struct fimc_md *fmd,
626 struct device_node *parent)
628 struct device_node *node;
631 for_each_available_child_of_node(parent, node) {
632 struct platform_device *pdev;
633 int plat_entity = -1;
635 pdev = of_find_device_by_node(node);
639 /* If driver of any entity isn't ready try all again later. */
640 if (!strcmp(node->name, CSIS_OF_NODE_NAME))
641 plat_entity = IDX_CSIS;
642 else if (!strcmp(node->name, FIMC_IS_OF_NODE_NAME))
643 plat_entity = IDX_IS_ISP;
644 else if (!strcmp(node->name, FIMC_LITE_OF_NODE_NAME))
645 plat_entity = IDX_FLITE;
646 else if (!strcmp(node->name, FIMC_OF_NODE_NAME) &&
647 !of_property_read_bool(node, "samsung,lcd-wb"))
648 plat_entity = IDX_FIMC;
650 if (plat_entity >= 0)
651 ret = fimc_md_register_platform_entity(fmd, pdev,
653 put_device(&pdev->dev);
661 static void fimc_md_unregister_entities(struct fimc_md *fmd)
665 for (i = 0; i < FIMC_MAX_DEVS; i++) {
666 struct fimc_dev *dev = fmd->fimc[i];
669 v4l2_device_unregister_subdev(&dev->vid_cap.subdev);
670 dev->vid_cap.ve.pipe = NULL;
673 for (i = 0; i < FIMC_LITE_MAX_DEVS; i++) {
674 struct fimc_lite *dev = fmd->fimc_lite[i];
677 v4l2_device_unregister_subdev(&dev->subdev);
679 fmd->fimc_lite[i] = NULL;
681 for (i = 0; i < CSIS_MAX_ENTITIES; i++) {
682 if (fmd->csis[i].sd == NULL)
684 v4l2_device_unregister_subdev(fmd->csis[i].sd);
685 fmd->csis[i].sd = NULL;
689 v4l2_device_unregister_subdev(&fmd->fimc_is->isp.subdev);
691 v4l2_info(&fmd->v4l2_dev, "Unregistered all entities\n");
695 * __fimc_md_create_fimc_links - create links to all FIMC entities
696 * @fmd: fimc media device
697 * @source: the source entity to create links to all fimc entities from
698 * @sensor: sensor subdev linked to FIMC[fimc_id] entity, may be null
699 * @pad: the source entity pad index
700 * @link_mask: bitmask of the fimc devices for which link should be enabled
702 static int __fimc_md_create_fimc_sink_links(struct fimc_md *fmd,
703 struct media_entity *source,
704 struct v4l2_subdev *sensor,
705 int pad, int link_mask)
707 struct fimc_source_info *si = NULL;
708 struct media_entity *sink;
709 unsigned int flags = 0;
713 si = v4l2_get_subdev_hostdata(sensor);
714 /* Skip direct FIMC links in the logical FIMC-IS sensor path */
715 if (si && si->fimc_bus_type == FIMC_BUS_TYPE_ISP_WRITEBACK)
719 for (i = 0; !ret && i < FIMC_MAX_DEVS; i++) {
723 * Some FIMC variants are not fitted with camera capture
724 * interface. Skip creating a link from sensor for those.
726 if (!fmd->fimc[i]->variant->has_cam_if)
729 flags = ((1 << i) & link_mask) ? MEDIA_LNK_FL_ENABLED : 0;
731 sink = &fmd->fimc[i]->vid_cap.subdev.entity;
732 ret = media_entity_create_link(source, pad, sink,
733 FIMC_SD_PAD_SINK_CAM, flags);
737 /* Notify FIMC capture subdev entity */
738 ret = media_entity_call(sink, link_setup, &sink->pads[0],
739 &source->pads[pad], flags);
743 v4l2_info(&fmd->v4l2_dev, "created link [%s] %c> [%s]\n",
744 source->name, flags ? '=' : '-', sink->name);
747 for (i = 0; i < FIMC_LITE_MAX_DEVS; i++) {
748 if (!fmd->fimc_lite[i])
751 sink = &fmd->fimc_lite[i]->subdev.entity;
752 ret = media_entity_create_link(source, pad, sink,
753 FLITE_SD_PAD_SINK, 0);
757 /* Notify FIMC-LITE subdev entity */
758 ret = media_entity_call(sink, link_setup, &sink->pads[0],
759 &source->pads[pad], 0);
763 v4l2_info(&fmd->v4l2_dev, "created link [%s] -> [%s]\n",
764 source->name, sink->name);
769 /* Create links from FIMC-LITE source pads to other entities */
770 static int __fimc_md_create_flite_source_links(struct fimc_md *fmd)
772 struct media_entity *source, *sink;
775 for (i = 0; i < FIMC_LITE_MAX_DEVS; i++) {
776 struct fimc_lite *fimc = fmd->fimc_lite[i];
781 source = &fimc->subdev.entity;
782 sink = &fimc->ve.vdev.entity;
783 /* FIMC-LITE's subdev and video node */
784 ret = media_entity_create_link(source, FLITE_SD_PAD_SOURCE_DMA,
788 /* Link from FIMC-LITE to IS-ISP subdev */
789 sink = &fmd->fimc_is->isp.subdev.entity;
790 ret = media_entity_create_link(source, FLITE_SD_PAD_SOURCE_ISP,
799 /* Create FIMC-IS links */
800 static int __fimc_md_create_fimc_is_links(struct fimc_md *fmd)
802 struct fimc_isp *isp = &fmd->fimc_is->isp;
803 struct media_entity *source, *sink;
806 source = &isp->subdev.entity;
808 for (i = 0; i < FIMC_MAX_DEVS; i++) {
809 if (fmd->fimc[i] == NULL)
812 /* Link from FIMC-IS-ISP subdev to FIMC */
813 sink = &fmd->fimc[i]->vid_cap.subdev.entity;
814 ret = media_entity_create_link(source, FIMC_ISP_SD_PAD_SRC_FIFO,
815 sink, FIMC_SD_PAD_SINK_FIFO, 0);
820 /* Link from FIMC-IS-ISP subdev to fimc-is-isp.capture video node */
821 sink = &isp->video_capture.ve.vdev.entity;
823 /* Skip this link if the fimc-is-isp video node driver isn't built-in */
824 if (sink->num_pads == 0)
827 return media_entity_create_link(source, FIMC_ISP_SD_PAD_SRC_DMA,
832 * fimc_md_create_links - create default links between registered entities
834 * Parallel interface sensor entities are connected directly to FIMC capture
835 * entities. The sensors using MIPI CSIS bus are connected through immutable
836 * link with CSI receiver entity specified by mux_id. Any registered CSIS
837 * entity has a link to each registered FIMC capture entity. Enabled links
838 * are created by default between each subsequent registered sensor and
839 * subsequent FIMC capture entity. The number of default active links is
840 * determined by the number of available sensors or FIMC entities,
843 static int fimc_md_create_links(struct fimc_md *fmd)
845 struct v4l2_subdev *csi_sensors[CSIS_MAX_ENTITIES] = { NULL };
846 struct v4l2_subdev *sensor, *csis;
847 struct fimc_source_info *pdata;
848 struct media_entity *source, *sink;
849 int i, pad, fimc_id = 0, ret = 0;
850 u32 flags, link_mask = 0;
852 for (i = 0; i < fmd->num_sensors; i++) {
853 if (fmd->sensor[i].subdev == NULL)
856 sensor = fmd->sensor[i].subdev;
857 pdata = v4l2_get_subdev_hostdata(sensor);
863 switch (pdata->sensor_bus_type) {
864 case FIMC_BUS_TYPE_MIPI_CSI2:
865 if (WARN(pdata->mux_id >= CSIS_MAX_ENTITIES,
866 "Wrong CSI channel id: %d\n", pdata->mux_id))
869 csis = fmd->csis[pdata->mux_id].sd;
870 if (WARN(csis == NULL,
871 "MIPI-CSI interface specified "
872 "but s5p-csis module is not loaded!\n"))
875 pad = sensor->entity.num_pads - 1;
876 ret = media_entity_create_link(&sensor->entity, pad,
877 &csis->entity, CSIS_PAD_SINK,
878 MEDIA_LNK_FL_IMMUTABLE |
879 MEDIA_LNK_FL_ENABLED);
883 v4l2_info(&fmd->v4l2_dev, "created link [%s] => [%s]\n",
884 sensor->entity.name, csis->entity.name);
887 csi_sensors[pdata->mux_id] = sensor;
890 case FIMC_BUS_TYPE_ITU_601...FIMC_BUS_TYPE_ITU_656:
891 source = &sensor->entity;
896 v4l2_err(&fmd->v4l2_dev, "Wrong bus_type: %x\n",
897 pdata->sensor_bus_type);
903 link_mask = 1 << fimc_id++;
904 ret = __fimc_md_create_fimc_sink_links(fmd, source, sensor,
908 for (i = 0; i < CSIS_MAX_ENTITIES; i++) {
909 if (fmd->csis[i].sd == NULL)
912 source = &fmd->csis[i].sd->entity;
913 pad = CSIS_PAD_SOURCE;
914 sensor = csi_sensors[i];
916 link_mask = 1 << fimc_id++;
917 ret = __fimc_md_create_fimc_sink_links(fmd, source, sensor,
921 /* Create immutable links between each FIMC's subdev and video node */
922 flags = MEDIA_LNK_FL_IMMUTABLE | MEDIA_LNK_FL_ENABLED;
923 for (i = 0; i < FIMC_MAX_DEVS; i++) {
927 source = &fmd->fimc[i]->vid_cap.subdev.entity;
928 sink = &fmd->fimc[i]->vid_cap.ve.vdev.entity;
930 ret = media_entity_create_link(source, FIMC_SD_PAD_SOURCE,
936 ret = __fimc_md_create_flite_source_links(fmd);
941 ret = __fimc_md_create_fimc_is_links(fmd);
947 * The peripheral sensor and CAM_BLK (PIXELASYNCMx) clocks management.
949 static void fimc_md_put_clocks(struct fimc_md *fmd)
951 int i = FIMC_MAX_CAMCLKS;
954 if (IS_ERR(fmd->camclk[i].clock))
956 clk_put(fmd->camclk[i].clock);
957 fmd->camclk[i].clock = ERR_PTR(-EINVAL);
960 /* Writeback (PIXELASYNCMx) clocks */
961 for (i = 0; i < FIMC_MAX_WBCLKS; i++) {
962 if (IS_ERR(fmd->wbclk[i]))
964 clk_put(fmd->wbclk[i]);
965 fmd->wbclk[i] = ERR_PTR(-EINVAL);
969 static int fimc_md_get_clocks(struct fimc_md *fmd)
971 struct device *dev = &fmd->pdev->dev;
976 for (i = 0; i < FIMC_MAX_CAMCLKS; i++)
977 fmd->camclk[i].clock = ERR_PTR(-EINVAL);
979 for (i = 0; i < FIMC_MAX_CAMCLKS; i++) {
980 snprintf(clk_name, sizeof(clk_name), "sclk_cam%u", i);
981 clock = clk_get(dev, clk_name);
984 dev_err(dev, "Failed to get clock: %s\n", clk_name);
985 ret = PTR_ERR(clock);
988 fmd->camclk[i].clock = clock;
991 fimc_md_put_clocks(fmd);
996 * For now get only PIXELASYNCM1 clock (Writeback B/ISP),
997 * leave PIXELASYNCM0 out for the LCD Writeback driver.
999 fmd->wbclk[CLK_IDX_WB_A] = ERR_PTR(-EINVAL);
1001 for (i = CLK_IDX_WB_B; i < FIMC_MAX_WBCLKS; i++) {
1002 snprintf(clk_name, sizeof(clk_name), "pxl_async%u", i);
1003 clock = clk_get(dev, clk_name);
1004 if (IS_ERR(clock)) {
1005 v4l2_err(&fmd->v4l2_dev, "Failed to get clock: %s\n",
1007 ret = PTR_ERR(clock);
1010 fmd->wbclk[i] = clock;
1013 fimc_md_put_clocks(fmd);
1018 static int __fimc_md_modify_pipeline(struct media_entity *entity, bool enable)
1020 struct exynos_video_entity *ve;
1021 struct fimc_pipeline *p;
1022 struct video_device *vdev;
1025 vdev = media_entity_to_video_device(entity);
1026 if (vdev->entity.use_count == 0)
1029 ve = vdev_to_exynos_video_entity(vdev);
1030 p = to_fimc_pipeline(ve->pipe);
1032 * Nothing to do if we are disabling the pipeline, some link
1033 * has been disconnected and p->subdevs array is cleared now.
1035 if (!enable && p->subdevs[IDX_SENSOR] == NULL)
1039 ret = __fimc_pipeline_open(ve->pipe, entity, true);
1041 ret = __fimc_pipeline_close(ve->pipe);
1043 if (ret == 0 && !enable)
1044 memset(p->subdevs, 0, sizeof(p->subdevs));
1049 /* Locking: called with entity->parent->graph_mutex mutex held. */
1050 static int __fimc_md_modify_pipelines(struct media_entity *entity, bool enable)
1052 struct media_entity *entity_err = entity;
1053 struct media_entity_graph graph;
1057 * Walk current graph and call the pipeline open/close routine for each
1058 * opened video node that belongs to the graph of entities connected
1059 * through active links. This is needed as we cannot power on/off the
1060 * subdevs in random order.
1062 media_entity_graph_walk_start(&graph, entity);
1064 while ((entity = media_entity_graph_walk_next(&graph))) {
1065 if (media_entity_type(entity) != MEDIA_ENT_T_DEVNODE)
1068 ret = __fimc_md_modify_pipeline(entity, enable);
1076 media_entity_graph_walk_start(&graph, entity_err);
1078 while ((entity_err = media_entity_graph_walk_next(&graph))) {
1079 if (media_entity_type(entity_err) != MEDIA_ENT_T_DEVNODE)
1082 __fimc_md_modify_pipeline(entity_err, !enable);
1084 if (entity_err == entity)
1091 static int fimc_md_link_notify(struct media_link *link, unsigned int flags,
1092 unsigned int notification)
1094 struct media_entity *sink = link->sink->entity;
1097 /* Before link disconnection */
1098 if (notification == MEDIA_DEV_NOTIFY_PRE_LINK_CH) {
1099 if (!(flags & MEDIA_LNK_FL_ENABLED))
1100 ret = __fimc_md_modify_pipelines(sink, false);
1103 /* TODO: Link state change validation */
1105 /* After link activation */
1106 } else if (notification == MEDIA_DEV_NOTIFY_POST_LINK_CH &&
1107 (link->flags & MEDIA_LNK_FL_ENABLED)) {
1108 ret = __fimc_md_modify_pipelines(sink, true);
1111 return ret ? -EPIPE : 0;
1114 static ssize_t fimc_md_sysfs_show(struct device *dev,
1115 struct device_attribute *attr, char *buf)
1117 struct platform_device *pdev = to_platform_device(dev);
1118 struct fimc_md *fmd = platform_get_drvdata(pdev);
1120 if (fmd->user_subdev_api)
1121 return strlcpy(buf, "Sub-device API (sub-dev)\n", PAGE_SIZE);
1123 return strlcpy(buf, "V4L2 video node only API (vid-dev)\n", PAGE_SIZE);
1126 static ssize_t fimc_md_sysfs_store(struct device *dev,
1127 struct device_attribute *attr,
1128 const char *buf, size_t count)
1130 struct platform_device *pdev = to_platform_device(dev);
1131 struct fimc_md *fmd = platform_get_drvdata(pdev);
1135 if (!strcmp(buf, "vid-dev\n"))
1137 else if (!strcmp(buf, "sub-dev\n"))
1142 fmd->user_subdev_api = subdev_api;
1143 for (i = 0; i < FIMC_MAX_DEVS; i++)
1145 fmd->fimc[i]->vid_cap.user_subdev_api = subdev_api;
1149 * This device attribute is to select video pipeline configuration method.
1150 * There are following valid values:
1151 * vid-dev - for V4L2 video node API only, subdevice will be configured
1152 * by the host driver.
1153 * sub-dev - for media controller API, subdevs must be configured in user
1154 * space before starting streaming.
1156 static DEVICE_ATTR(subdev_conf_mode, S_IWUSR | S_IRUGO,
1157 fimc_md_sysfs_show, fimc_md_sysfs_store);
1159 static int fimc_md_get_pinctrl(struct fimc_md *fmd)
1161 struct device *dev = &fmd->pdev->dev;
1162 struct fimc_pinctrl *pctl = &fmd->pinctl;
1164 pctl->pinctrl = devm_pinctrl_get(dev);
1165 if (IS_ERR(pctl->pinctrl))
1166 return PTR_ERR(pctl->pinctrl);
1168 pctl->state_default = pinctrl_lookup_state(pctl->pinctrl,
1169 PINCTRL_STATE_DEFAULT);
1170 if (IS_ERR(pctl->state_default))
1171 return PTR_ERR(pctl->state_default);
1173 pctl->state_idle = pinctrl_lookup_state(pctl->pinctrl,
1174 PINCTRL_STATE_IDLE);
1178 static int cam_clk_prepare(struct clk_hw *hw)
1180 struct cam_clk *camclk = to_cam_clk(hw);
1183 if (camclk->fmd->pmf == NULL)
1186 ret = pm_runtime_get_sync(camclk->fmd->pmf);
1187 return ret < 0 ? ret : 0;
1190 static void cam_clk_unprepare(struct clk_hw *hw)
1192 struct cam_clk *camclk = to_cam_clk(hw);
1194 if (camclk->fmd->pmf == NULL)
1197 pm_runtime_put_sync(camclk->fmd->pmf);
1200 static const struct clk_ops cam_clk_ops = {
1201 .prepare = cam_clk_prepare,
1202 .unprepare = cam_clk_unprepare,
1205 static void fimc_md_unregister_clk_provider(struct fimc_md *fmd)
1207 struct cam_clk_provider *cp = &fmd->clk_provider;
1211 of_clk_del_provider(cp->of_node);
1213 for (i = 0; i < cp->num_clocks; i++)
1214 clk_unregister(cp->clks[i]);
1217 static int fimc_md_register_clk_provider(struct fimc_md *fmd)
1219 struct cam_clk_provider *cp = &fmd->clk_provider;
1220 struct device *dev = &fmd->pdev->dev;
1223 for (i = 0; i < FIMC_MAX_CAMCLKS; i++) {
1224 struct cam_clk *camclk = &cp->camclk[i];
1225 struct clk_init_data init;
1228 ret = of_property_read_string_index(dev->of_node,
1229 "clock-output-names", i, &init.name);
1233 p_name = __clk_get_name(fmd->camclk[i].clock);
1235 /* It's safe since clk_register() will duplicate the string. */
1236 init.parent_names = &p_name;
1237 init.num_parents = 1;
1238 init.ops = &cam_clk_ops;
1239 init.flags = CLK_SET_RATE_PARENT;
1240 camclk->hw.init = &init;
1243 cp->clks[i] = clk_register(NULL, &camclk->hw);
1244 if (IS_ERR(cp->clks[i])) {
1245 dev_err(dev, "failed to register clock: %s (%ld)\n",
1246 init.name, PTR_ERR(cp->clks[i]));
1247 ret = PTR_ERR(cp->clks[i]);
1253 if (cp->num_clocks == 0) {
1254 dev_warn(dev, "clk provider not registered\n");
1258 cp->clk_data.clks = cp->clks;
1259 cp->clk_data.clk_num = cp->num_clocks;
1260 cp->of_node = dev->of_node;
1261 ret = of_clk_add_provider(dev->of_node, of_clk_src_onecell_get,
1266 fimc_md_unregister_clk_provider(fmd);
1270 static int subdev_notifier_bound(struct v4l2_async_notifier *notifier,
1271 struct v4l2_subdev *subdev,
1272 struct v4l2_async_subdev *asd)
1274 struct fimc_md *fmd = notifier_to_fimc_md(notifier);
1275 struct fimc_sensor_info *si = NULL;
1278 /* Find platform data for this sensor subdev */
1279 for (i = 0; i < ARRAY_SIZE(fmd->sensor); i++)
1280 if (fmd->sensor[i].asd.match.of.node == subdev->dev->of_node)
1281 si = &fmd->sensor[i];
1286 v4l2_set_subdev_hostdata(subdev, &si->pdata);
1288 if (si->pdata.fimc_bus_type == FIMC_BUS_TYPE_ISP_WRITEBACK)
1289 subdev->grp_id = GRP_ID_FIMC_IS_SENSOR;
1291 subdev->grp_id = GRP_ID_SENSOR;
1293 si->subdev = subdev;
1295 v4l2_info(&fmd->v4l2_dev, "Registered sensor subdevice: %s (%d)\n",
1296 subdev->name, fmd->num_sensors);
1303 static int subdev_notifier_complete(struct v4l2_async_notifier *notifier)
1305 struct fimc_md *fmd = notifier_to_fimc_md(notifier);
1308 mutex_lock(&fmd->media_dev.graph_mutex);
1310 ret = fimc_md_create_links(fmd);
1314 ret = v4l2_device_register_subdev_nodes(&fmd->v4l2_dev);
1316 mutex_unlock(&fmd->media_dev.graph_mutex);
1320 static int fimc_md_probe(struct platform_device *pdev)
1322 struct device *dev = &pdev->dev;
1323 struct v4l2_device *v4l2_dev;
1324 struct fimc_md *fmd;
1327 fmd = devm_kzalloc(dev, sizeof(*fmd), GFP_KERNEL);
1331 spin_lock_init(&fmd->slock);
1332 INIT_LIST_HEAD(&fmd->pipelines);
1335 strlcpy(fmd->media_dev.model, "SAMSUNG S5P FIMC",
1336 sizeof(fmd->media_dev.model));
1337 fmd->media_dev.link_notify = fimc_md_link_notify;
1338 fmd->media_dev.dev = dev;
1340 v4l2_dev = &fmd->v4l2_dev;
1341 v4l2_dev->mdev = &fmd->media_dev;
1342 v4l2_dev->notify = fimc_sensor_notify;
1343 strlcpy(v4l2_dev->name, "s5p-fimc-md", sizeof(v4l2_dev->name));
1345 fmd->use_isp = fimc_md_is_isp_available(dev->of_node);
1346 fmd->user_subdev_api = true;
1348 ret = v4l2_device_register(dev, &fmd->v4l2_dev);
1350 v4l2_err(v4l2_dev, "Failed to register v4l2_device: %d\n", ret);
1354 ret = media_device_register(&fmd->media_dev);
1356 v4l2_err(v4l2_dev, "Failed to register media device: %d\n", ret);
1360 ret = fimc_md_get_clocks(fmd);
1364 ret = fimc_md_get_pinctrl(fmd);
1366 if (ret != EPROBE_DEFER)
1367 dev_err(dev, "Failed to get pinctrl: %d\n", ret);
1371 platform_set_drvdata(pdev, fmd);
1373 /* Protect the media graph while we're registering entities */
1374 mutex_lock(&fmd->media_dev.graph_mutex);
1376 ret = fimc_md_register_platform_entities(fmd, dev->of_node);
1378 mutex_unlock(&fmd->media_dev.graph_mutex);
1382 ret = fimc_md_register_sensor_entities(fmd);
1384 mutex_unlock(&fmd->media_dev.graph_mutex);
1388 mutex_unlock(&fmd->media_dev.graph_mutex);
1390 ret = device_create_file(&pdev->dev, &dev_attr_subdev_conf_mode);
1394 * FIMC platform devices need to be registered before the sclk_cam
1395 * clocks provider, as one of these devices needs to be activated
1396 * to enable the clock.
1398 ret = fimc_md_register_clk_provider(fmd);
1400 v4l2_err(v4l2_dev, "clock provider registration failed\n");
1404 if (fmd->num_sensors > 0) {
1405 fmd->subdev_notifier.subdevs = fmd->async_subdevs;
1406 fmd->subdev_notifier.num_subdevs = fmd->num_sensors;
1407 fmd->subdev_notifier.bound = subdev_notifier_bound;
1408 fmd->subdev_notifier.complete = subdev_notifier_complete;
1409 fmd->num_sensors = 0;
1411 ret = v4l2_async_notifier_register(&fmd->v4l2_dev,
1412 &fmd->subdev_notifier);
1420 fimc_md_unregister_clk_provider(fmd);
1422 device_remove_file(&pdev->dev, &dev_attr_subdev_conf_mode);
1424 fimc_md_put_clocks(fmd);
1426 fimc_md_unregister_entities(fmd);
1428 media_device_unregister(&fmd->media_dev);
1430 v4l2_device_unregister(&fmd->v4l2_dev);
1434 static int fimc_md_remove(struct platform_device *pdev)
1436 struct fimc_md *fmd = platform_get_drvdata(pdev);
1441 fimc_md_unregister_clk_provider(fmd);
1442 v4l2_async_notifier_unregister(&fmd->subdev_notifier);
1444 v4l2_device_unregister(&fmd->v4l2_dev);
1445 device_remove_file(&pdev->dev, &dev_attr_subdev_conf_mode);
1446 fimc_md_unregister_entities(fmd);
1447 fimc_md_pipelines_free(fmd);
1448 media_device_unregister(&fmd->media_dev);
1449 fimc_md_put_clocks(fmd);
1454 static const struct platform_device_id fimc_driver_ids[] __always_unused = {
1455 { .name = "s5p-fimc-md" },
1458 MODULE_DEVICE_TABLE(platform, fimc_driver_ids);
1460 static const struct of_device_id fimc_md_of_match[] = {
1461 { .compatible = "samsung,fimc" },
1464 MODULE_DEVICE_TABLE(of, fimc_md_of_match);
1466 static struct platform_driver fimc_md_driver = {
1467 .probe = fimc_md_probe,
1468 .remove = fimc_md_remove,
1470 .of_match_table = of_match_ptr(fimc_md_of_match),
1471 .name = "s5p-fimc-md",
1475 static int __init fimc_md_init(void)
1479 request_module("s5p-csis");
1480 ret = fimc_register_driver();
1484 return platform_driver_register(&fimc_md_driver);
1487 static void __exit fimc_md_exit(void)
1489 platform_driver_unregister(&fimc_md_driver);
1490 fimc_unregister_driver();
1493 module_init(fimc_md_init);
1494 module_exit(fimc_md_exit);
1496 MODULE_AUTHOR("Sylwester Nawrocki <s.nawrocki@samsung.com>");
1497 MODULE_DESCRIPTION("S5P FIMC camera host interface/video postprocessor driver");
1498 MODULE_LICENSE("GPL");
1499 MODULE_VERSION("2.0.1");