include/media/s5p_fimc.h

   1 /*
   2  * Samsung S5P/Exynos4 SoC series camera interface driver header
   3  *
   4  * Copyright (C) 2010 - 2013 Samsung Electronics Co., Ltd.
   5  * 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 /*
  18  * Enumeration of the FIMC data bus types.
  19  */
  20 enum fimc_bus_type {
  21         /* Camera parallel bus */
  22         FIMC_BUS_TYPE_ITU_601 = 1,
  23         /* Camera parallel bus with embedded synchronization */
  24         FIMC_BUS_TYPE_ITU_656,
  25         /* Camera MIPI-CSI2 serial bus */
  26         FIMC_BUS_TYPE_MIPI_CSI2,
  27         /* FIFO link from LCD controller (WriteBack A) */
  28         FIMC_BUS_TYPE_LCD_WRITEBACK_A,
  29         /* FIFO link from LCD controller (WriteBack B) */
  30         FIMC_BUS_TYPE_LCD_WRITEBACK_B,
  31         /* FIFO link from FIMC-IS */
  32         FIMC_BUS_TYPE_ISP_WRITEBACK = FIMC_BUS_TYPE_LCD_WRITEBACK_B,
  33 };
  34
  35 struct i2c_board_info;
  36
  37 /**
  38  * struct fimc_source_info - video source description required for the host
  39  *                           interface configuration
  40  *
  41  * @board_info: pointer to I2C subdevice's board info
  42  * @clk_frequency: frequency of the clock the host interface provides to sensor
  43  * @fimc_bus_type: FIMC camera input type
  44  * @sensor_bus_type: image sensor bus type, MIPI, ITU-R BT.601 etc.
  45  * @flags: the parallel sensor bus flags defining signals polarity (V4L2_MBUS_*)
  46  * @i2c_bus_num: i2c control bus id the sensor is attached to
  47  * @mux_id: FIMC camera interface multiplexer index (separate for MIPI and ITU)
  48  * @clk_id: index of the SoC peripheral clock for sensors
  49  */
  50 struct fimc_source_info {
  51         struct i2c_board_info *board_info;
  52         unsigned long clk_frequency;
  53         enum fimc_bus_type fimc_bus_type;
  54         enum fimc_bus_type sensor_bus_type;
  55         u16 flags;
  56         u16 i2c_bus_num;
  57         u16 mux_id;
  58         u8 clk_id;
  59 };
  60
  61 /**
  62  * struct s5p_platform_fimc - camera host interface platform data
  63  *
  64  * @source_info: properties of an image source for the host interface setup
  65  * @num_clients: the number of attached image sources
  66  */
  67 struct s5p_platform_fimc {
  68         struct fimc_source_info *source_info;
  69         int num_clients;
  70 };
  71
  72 /*
  73  * v4l2_device notification id. This is only for internal use in the kernel.
  74  * Sensor subdevs should issue S5P_FIMC_TX_END_NOTIFY notification in single
  75  * frame capture mode when there is only one VSYNC pulse issued by the sensor
  76  * at begining of the frame transmission.
  77  */
  78 #define S5P_FIMC_TX_END_NOTIFY _IO('e', 0)
  79
  80 enum fimc_subdev_index {
  81         IDX_SENSOR,
  82         IDX_CSIS,
  83         IDX_FLITE,
  84         IDX_FIMC,
  85         IDX_MAX,
  86 };
  87
  88 struct media_pipeline;
  89 struct v4l2_subdev;
  90
  91 struct fimc_pipeline {
  92         struct v4l2_subdev *subdevs[IDX_MAX];
  93         struct media_pipeline *m_pipeline;
  94 };
  95
  96 /*
  97  * Media pipeline operations to be called from within the fimc(-lite)
  98  * video node when it is the last entity of the pipeline. Implemented
  99  * by corresponding media device driver.
 100  */
 101 struct fimc_pipeline_ops {
 102         int (*open)(struct fimc_pipeline *p, struct media_entity *me,
 103                           bool resume);
 104         int (*close)(struct fimc_pipeline *p);
 105         int (*set_stream)(struct fimc_pipeline *p, bool state);
 106 };
 107
 108 #define fimc_pipeline_call(f, op, p, args...)                           \
 109         (!(f) ? -ENODEV : (((f)->pipeline_ops && (f)->pipeline_ops->op) ? \
 110                             (f)->pipeline_ops->op((p), ##args) : -ENOIOCTLCMD))
 111
 112 #endif /* S5P_FIMC_H_ */