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/drv-intf/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_create_pad_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_create_pad_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_create_pad_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_create_pad_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_create_pad_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_create_pad_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_create_pad_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_create_pad_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");