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  * @csi_data_align: MIPI-CSI interface data alignment in bits
  34  * @i2c_bus_num: i2c control bus id the sensor is attached to
  35  * @mux_id: FIMC camera interface multiplexer index (separate for MIPI and ITU)
  36  * @clk_id: index of the SoC peripheral clock for sensors
  37  * @flags: the parallel bus flags defining signals polarity (V4L2_MBUS_*)
  38  */
  39 struct s5p_fimc_isp_info {
  40         struct i2c_board_info *board_info;
  41         unsigned long clk_frequency;
  42         enum cam_bus_type bus_type;
  43         u16 csi_data_align;
  44         u16 i2c_bus_num;
  45         u16 mux_id;
  46         u16 flags;
  47         u8 clk_id;
  48 };
  49
  50 /**
  51  * struct s5p_platform_fimc - camera host interface platform data
  52  *
  53  * @isp_info: properties of camera sensor required for host interface setup
  54  * @num_clients: the number of attached image sensors
  55  */
  56 struct s5p_platform_fimc {
  57         struct s5p_fimc_isp_info *isp_info;
  58         int num_clients;
  59 };
  60
  61 /*
  62  * v4l2_device notification id. This is only for internal use in the kernel.
  63  * Sensor subdevs should issue S5P_FIMC_TX_END_NOTIFY notification in single
  64  * frame capture mode when there is only one VSYNC pulse issued by the sensor
  65  * at begining of the frame transmission.
  66  */
  67 #define S5P_FIMC_TX_END_NOTIFY _IO('e', 0)
  68
  69 enum fimc_subdev_index {
  70         IDX_SENSOR,
  71         IDX_CSIS,
  72         IDX_FLITE,
  73         IDX_FIMC,
  74         IDX_MAX,
  75 };
  76
  77 struct media_pipeline;
  78 struct v4l2_subdev;
  79
  80 struct fimc_pipeline {
  81         struct v4l2_subdev *subdevs[IDX_MAX];
  82         struct media_pipeline *m_pipeline;
  83 };
  84
  85 /*
  86  * Media pipeline operations to be called from within the fimc(-lite)
  87  * video node when it is the last entity of the pipeline. Implemented
  88  * by corresponding media device driver.
  89  */
  90 struct fimc_pipeline_ops {
  91         int (*open)(struct fimc_pipeline *p, struct media_entity *me,
  92                           bool resume);
  93         int (*close)(struct fimc_pipeline *p);
  94         int (*set_stream)(struct fimc_pipeline *p, bool state);
  95 };
  96
  97 #define fimc_pipeline_call(f, op, p, args...)                           \
  98         (!(f) ? -ENODEV : (((f)->pipeline_ops && (f)->pipeline_ops->op) ? \
  99                             (f)->pipeline_ops->op((p), ##args) : -ENOIOCTLCMD))
 100
 101 #endif /* S5P_FIMC_H_ */