1 /*
2 * Copyright (C) 2011 - 2012 Samsung Electronics Co., Ltd.
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License version 2 as
6 * published by the Free Software Foundation.
7 */
8
9 #ifndef FIMC_MDEVICE_H_
10 #define FIMC_MDEVICE_H_
11
12 #include <linux/clk.h>
13 #include <linux/clk-provider.h>
14 #include <linux/platform_device.h>
15 #include <linux/mutex.h>
16 #include <linux/of.h>
17 #include <linux/pinctrl/consumer.h>
18 #include <media/media-device.h>
19 #include <media/media-entity.h>
20 #include <media/v4l2-device.h>
21 #include <media/v4l2-subdev.h>
22 #include <media/exynos-fimc.h>
23
24 #include "fimc-core.h"
25 #include "fimc-lite.h"
26 #include "mipi-csis.h"
27
28 #define FIMC_OF_NODE_NAME "fimc"
29 #define FIMC_LITE_OF_NODE_NAME "fimc-lite"
30 #define FIMC_IS_OF_NODE_NAME "fimc-is"
31 #define CSIS_OF_NODE_NAME "csis"
32
33 #define PINCTRL_STATE_IDLE "idle"
34
35 #define FIMC_MAX_SENSORS 4
36 #define FIMC_MAX_CAMCLKS 2
37 #define DEFAULT_SENSOR_CLK_FREQ 24000000U
38
39 /* LCD/ISP Writeback clocks (PIXELASYNCMx) */
40 enum {
41 CLK_IDX_WB_A,
42 CLK_IDX_WB_B,
43 FIMC_MAX_WBCLKS
44 };
45
46 enum fimc_subdev_index {
47 IDX_SENSOR,
48 IDX_CSIS,
49 IDX_FLITE,
50 IDX_IS_ISP,
51 IDX_FIMC,
52 IDX_MAX,
53 };
54
55 /*
56 * This structure represents a chain of media entities, including a data
57 * source entity (e.g. an image sensor subdevice), a data capture entity
58 * - a video capture device node and any remaining entities.
59 */
60 struct fimc_pipeline {
61 struct exynos_media_pipeline ep;
62 struct list_head list;
63 struct media_entity *vdev_entity;
64 struct v4l2_subdev *subdevs[IDX_MAX];
65 };
66
67 #define to_fimc_pipeline(_ep) container_of(_ep, struct fimc_pipeline, ep)
68
69 struct fimc_csis_info {
70 struct v4l2_subdev *sd;
71 int id;
72 };
73
74 struct fimc_camclk_info {
75 struct clk *clock;
76 int use_count;
77 unsigned long frequency;
78 };
79
80 /**
81 * struct fimc_sensor_info - image data source subdev information
82 * @pdata: sensor's atrributes passed as media device's platform data
83 * @asd: asynchronous subdev registration data structure
84 * @subdev: image sensor v4l2 subdev
85 * @host: fimc device the sensor is currently linked to
86 *
87 * This data structure applies to image sensor and the writeback subdevs.
88 */
89 struct fimc_sensor_info {
90 struct fimc_source_info pdata;
91 struct v4l2_async_subdev asd;
92 struct v4l2_subdev *subdev;
93 struct fimc_dev *host;
94 };
95
96 struct cam_clk {
97 struct clk_hw hw;
98 struct fimc_md *fmd;
99 };
100 #define to_cam_clk(_hw) container_of(_hw, struct cam_clk, hw)
101
102 /**
103 * struct fimc_md - fimc media device information
104 * @csis: MIPI CSIS subdevs data
105 * @sensor: array of registered sensor subdevs
106 * @num_sensors: actual number of registered sensors
107 * @camclk: external sensor clock information
108 * @fimc: array of registered fimc devices
109 * @fimc_is: fimc-is data structure
110 * @use_isp: set to true when FIMC-IS subsystem is used
111 * @pmf: handle to the CAMCLK clock control FIMC helper device
112 * @media_dev: top level media device
113 * @v4l2_dev: top level v4l2_device holding up the subdevs
114 * @pdev: platform device this media device is hooked up into
115 * @pinctrl: camera port pinctrl handle
116 * @state_default: pinctrl default state handle
117 * @state_idle: pinctrl idle state handle
118 * @cam_clk_provider: CAMCLK clock provider structure
119 * @user_subdev_api: true if subdevs are not configured by the host driver
120 * @slock: spinlock protecting @sensor array
121 */
122 struct fimc_md {
123 struct fimc_csis_info csis[CSIS_MAX_ENTITIES];
124 struct fimc_sensor_info sensor[FIMC_MAX_SENSORS];
125 int num_sensors;
126 struct fimc_camclk_info camclk[FIMC_MAX_CAMCLKS];
127 struct clk *wbclk[FIMC_MAX_WBCLKS];
128 struct fimc_lite *fimc_lite[FIMC_LITE_MAX_DEVS];
129 struct fimc_dev *fimc[FIMC_MAX_DEVS];
130 struct fimc_is *fimc_is;
131 bool use_isp;
132 struct device *pmf;
133 struct media_device media_dev;
134 struct v4l2_device v4l2_dev;
135 struct platform_device *pdev;
136
137 struct fimc_pinctrl {
138 struct pinctrl *pinctrl;
139 struct pinctrl_state *state_default;
140 struct pinctrl_state *state_idle;
141 } pinctl;
142
143 struct cam_clk_provider {
144 struct clk *clks[FIMC_MAX_CAMCLKS];
145 struct clk_onecell_data clk_data;
146 struct device_node *of_node;
147 struct cam_clk camclk[FIMC_MAX_CAMCLKS];
148 int num_clocks;
149 } clk_provider;
150
151 struct v4l2_async_notifier subdev_notifier;
152 struct v4l2_async_subdev *async_subdevs[FIMC_MAX_SENSORS];
153
154 bool user_subdev_api;
155 spinlock_t slock;
156 struct list_head pipelines;
157 };
158
159 static inline
source_to_sensor_info(struct fimc_source_info * si)160 struct fimc_sensor_info *source_to_sensor_info(struct fimc_source_info *si)
161 {
162 return container_of(si, struct fimc_sensor_info, pdata);
163 }
164
entity_to_fimc_mdev(struct media_entity * me)165 static inline struct fimc_md *entity_to_fimc_mdev(struct media_entity *me)
166 {
167 return me->parent == NULL ? NULL :
168 container_of(me->parent, struct fimc_md, media_dev);
169 }
170
notifier_to_fimc_md(struct v4l2_async_notifier * n)171 static inline struct fimc_md *notifier_to_fimc_md(struct v4l2_async_notifier *n)
172 {
173 return container_of(n, struct fimc_md, subdev_notifier);
174 }
175
fimc_md_graph_lock(struct exynos_video_entity * ve)176 static inline void fimc_md_graph_lock(struct exynos_video_entity *ve)
177 {
178 mutex_lock(&ve->vdev.entity.parent->graph_mutex);
179 }
180
fimc_md_graph_unlock(struct exynos_video_entity * ve)181 static inline void fimc_md_graph_unlock(struct exynos_video_entity *ve)
182 {
183 mutex_unlock(&ve->vdev.entity.parent->graph_mutex);
184 }
185
186 int fimc_md_set_camclk(struct v4l2_subdev *sd, bool on);
187
188 #ifdef CONFIG_OF
fimc_md_is_isp_available(struct device_node * node)189 static inline bool fimc_md_is_isp_available(struct device_node *node)
190 {
191 node = of_get_child_by_name(node, FIMC_IS_OF_NODE_NAME);
192 return node ? of_device_is_available(node) : false;
193 }
194 #else
195 #define fimc_md_is_isp_available(node) (false)
196 #endif /* CONFIG_OF */
197
__fimc_md_get_subdev(struct exynos_media_pipeline * ep,unsigned int index)198 static inline struct v4l2_subdev *__fimc_md_get_subdev(
199 struct exynos_media_pipeline *ep,
200 unsigned int index)
201 {
202 struct fimc_pipeline *p = to_fimc_pipeline(ep);
203
204 if (!p || index >= IDX_MAX)
205 return NULL;
206 else
207 return p->subdevs[index];
208 }
209
210 #endif
211