include/media/s5p_fimc.h

   1 /*
   2  * Samsung S5P SoC camera interface driver header
   3  *
   4  * Copyright (c) 2010 Samsung Electronics Co., Ltd
   5  * Author: Sylwester Nawrocki, <s.nawrocki@samsung.com>
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License version 2 as
   9  * published by the Free Software Foundation.
  10  */
  11
  12 #ifndef S5P_FIMC_H_
  13 #define S5P_FIMC_H_
  14
  15 #include <media/media-entity.h>
  16
  17 enum cam_bus_type {
  18         FIMC_ITU_601 = 1,
  19         FIMC_ITU_656,
  20         FIMC_MIPI_CSI2,
  21         FIMC_LCD_WB, /* FIFO link from LCD mixer */
  22 };
  23
  24 struct i2c_board_info;
  25
  26 /**
  27  * struct s5p_fimc_isp_info - image sensor information required for host
  28  *                            interace configuration.
  29  *
  30  * @board_info: pointer to I2C subdevice's board info
  31  * @clk_frequency: frequency of the clock the host interface provides to sensor
  32  * @bus_type: determines bus type, MIPI, ITU-R BT.601 etc.
  33  * @i2c_bus_num: i2c control bus id the sensor is attached to
  34  * @mux_id: FIMC camera interface multiplexer index (separate for MIPI and ITU)
  35  * @clk_id: index of the SoC peripheral clock for sensors
  36  * @flags: the parallel bus flags defining signals polarity (V4L2_MBUS_*)
  37  */
  38 struct s5p_fimc_isp_info {
  39         struct i2c_board_info *board_info;
  40         unsigned long clk_frequency;
  41         enum cam_bus_type bus_type;
  42         u16 i2c_bus_num;
  43         u16 mux_id;
  44         u16 flags;
  45         u8 clk_id;
  46 };
  47
  48 /**
  49  * struct s5p_platform_fimc - camera host interface platform data
  50  *
  51  * @isp_info: properties of camera sensor required for host interface setup
  52  * @num_clients: the number of attached image sensors
  53  */
  54 struct s5p_platform_fimc {
  55         struct s5p_fimc_isp_info *isp_info;
  56         int num_clients;
  57 };
  58
  59 /*
  60  * v4l2_device notification id. This is only for internal use in the kernel.
  61  * Sensor subdevs should issue S5P_FIMC_TX_END_NOTIFY notification in single
  62  * frame capture mode when there is only one VSYNC pulse issued by the sensor
  63  * at begining of the frame transmission.
  64  */
  65 #define S5P_FIMC_TX_END_NOTIFY _IO('e', 0)
  66
  67 enum fimc_subdev_index {
  68         IDX_SENSOR,
  69         IDX_CSIS,
  70         IDX_FLITE,
  71         IDX_FIMC,
  72         IDX_MAX,
  73 };
  74
  75 struct media_pipeline;
  76 struct v4l2_subdev;
  77
  78 struct fimc_pipeline {
  79         struct v4l2_subdev *subdevs[IDX_MAX];
  80         struct media_pipeline *m_pipeline;
  81 };
  82
  83 /*
  84  * Media pipeline operations to be called from within the fimc(-lite)
  85  * video node when it is the last entity of the pipeline. Implemented
  86  * by corresponding media device driver.
  87  */
  88 struct fimc_pipeline_ops {
  89         int (*open)(struct fimc_pipeline *p, struct media_entity *me,
  90                           bool resume);
  91         int (*close)(struct fimc_pipeline *p);
  92         int (*set_stream)(struct fimc_pipeline *p, bool state);
  93 };
  94
  95 #define fimc_pipeline_call(f, op, p, args...)                           \
  96         (!(f) ? -ENODEV : (((f)->pipeline_ops && (f)->pipeline_ops->op) ? \
  97                             (f)->pipeline_ops->op((p), ##args) : -ENOIOCTLCMD))
  98
  99 #endif /* S5P_FIMC_H_ */