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) */ 40enum { 41 CLK_IDX_WB_A, 42 CLK_IDX_WB_B, 43 FIMC_MAX_WBCLKS 44}; 45 46enum 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 */ 60struct 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 69struct fimc_csis_info { 70 struct v4l2_subdev *sd; 71 int id; 72}; 73 74struct 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 */ 89struct 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 96struct 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 */ 122struct 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 159static inline 160struct 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 165static 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 171static 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 176static inline void fimc_md_graph_lock(struct exynos_video_entity *ve) 177{ 178 mutex_lock(&ve->vdev.entity.parent->graph_mutex); 179} 180 181static inline void fimc_md_graph_unlock(struct exynos_video_entity *ve) 182{ 183 mutex_unlock(&ve->vdev.entity.parent->graph_mutex); 184} 185 186int fimc_md_set_camclk(struct v4l2_subdev *sd, bool on); 187 188#ifdef CONFIG_OF 189static 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 198static 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