drivers/media/platform/exynos4-is/media-dev.h

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