2 * Samsung S5P/Exynos4 SoC series camera interface driver header
4 * Copyright (C) 2010 - 2013 Samsung Electronics Co., Ltd.
5 * Sylwester Nawrocki <s.nawrocki@samsung.com>
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.
15 #include <media/media-entity.h>
16 #include <media/v4l2-mediabus.h>
19 * Enumeration of data inputs to the camera subsystem.
22 FIMC_INPUT_PARALLEL_0
= 1,
23 FIMC_INPUT_PARALLEL_1
,
24 FIMC_INPUT_MIPI_CSI2_0
= 3,
25 FIMC_INPUT_MIPI_CSI2_1
,
26 FIMC_INPUT_WRITEBACK_A
= 5,
27 FIMC_INPUT_WRITEBACK_B
,
28 FIMC_INPUT_WRITEBACK_ISP
= 5,
32 * Enumeration of the FIMC data bus types.
35 /* Camera parallel bus */
36 FIMC_BUS_TYPE_ITU_601
= 1,
37 /* Camera parallel bus with embedded synchronization */
38 FIMC_BUS_TYPE_ITU_656
,
39 /* Camera MIPI-CSI2 serial bus */
40 FIMC_BUS_TYPE_MIPI_CSI2
,
41 /* FIFO link from LCD controller (WriteBack A) */
42 FIMC_BUS_TYPE_LCD_WRITEBACK_A
,
43 /* FIFO link from LCD controller (WriteBack B) */
44 FIMC_BUS_TYPE_LCD_WRITEBACK_B
,
45 /* FIFO link from FIMC-IS */
46 FIMC_BUS_TYPE_ISP_WRITEBACK
= FIMC_BUS_TYPE_LCD_WRITEBACK_B
,
49 #define fimc_input_is_parallel(x) ((x) == 1 || (x) == 2)
50 #define fimc_input_is_mipi_csi(x) ((x) == 3 || (x) == 4)
53 * The subdevices' group IDs.
55 #define GRP_ID_SENSOR (1 << 8)
56 #define GRP_ID_FIMC_IS_SENSOR (1 << 9)
57 #define GRP_ID_WRITEBACK (1 << 10)
58 #define GRP_ID_CSIS (1 << 11)
59 #define GRP_ID_FIMC (1 << 12)
60 #define GRP_ID_FLITE (1 << 13)
61 #define GRP_ID_FIMC_IS (1 << 14)
63 struct i2c_board_info
;
66 * struct fimc_source_info - video source description required for the host
67 * interface configuration
69 * @board_info: pointer to I2C subdevice's board info
70 * @clk_frequency: frequency of the clock the host interface provides to sensor
71 * @fimc_bus_type: FIMC camera input type
72 * @sensor_bus_type: image sensor bus type, MIPI, ITU-R BT.601 etc.
73 * @flags: the parallel sensor bus flags defining signals polarity (V4L2_MBUS_*)
74 * @i2c_bus_num: i2c control bus id the sensor is attached to
75 * @mux_id: FIMC camera interface multiplexer index (separate for MIPI and ITU)
76 * @clk_id: index of the SoC peripheral clock for sensors
78 struct fimc_source_info
{
79 struct i2c_board_info
*board_info
;
80 unsigned long clk_frequency
;
81 enum fimc_bus_type fimc_bus_type
;
82 enum fimc_bus_type sensor_bus_type
;
90 * struct s5p_platform_fimc - camera host interface platform data
92 * @source_info: properties of an image source for the host interface setup
93 * @num_clients: the number of attached image sources
95 struct s5p_platform_fimc
{
96 struct fimc_source_info
*source_info
;
101 * v4l2_device notification id. This is only for internal use in the kernel.
102 * Sensor subdevs should issue S5P_FIMC_TX_END_NOTIFY notification in single
103 * frame capture mode when there is only one VSYNC pulse issued by the sensor
104 * at begining of the frame transmission.
106 #define S5P_FIMC_TX_END_NOTIFY _IO('e', 0)
108 #define FIMC_MAX_PLANES 3
111 * struct fimc_fmt - color format data structure
112 * @mbus_code: media bus pixel code, -1 if not applicable
113 * @name: format description
114 * @fourcc: fourcc code for this format, 0 if not applicable
115 * @color: the driver's private color format id
116 * @memplanes: number of physically non-contiguous data planes
117 * @colplanes: number of physically contiguous data planes
118 * @depth: per plane driver's private 'number of bits per pixel'
119 * @mdataplanes: bitmask indicating meta data plane(s), (1 << plane_no)
120 * @flags: flags indicating which operation mode format applies to
123 enum v4l2_mbus_pixelcode mbus_code
;
129 u8 depth
[FIMC_MAX_PLANES
];
132 #define FMT_FLAGS_CAM (1 << 0)
133 #define FMT_FLAGS_M2M_IN (1 << 1)
134 #define FMT_FLAGS_M2M_OUT (1 << 2)
135 #define FMT_FLAGS_M2M (1 << 1 | 1 << 2)
136 #define FMT_HAS_ALPHA (1 << 3)
137 #define FMT_FLAGS_COMPRESSED (1 << 4)
138 #define FMT_FLAGS_WRITEBACK (1 << 5)
139 #define FMT_FLAGS_RAW_BAYER (1 << 6)
140 #define FMT_FLAGS_YUV (1 << 7)
143 enum fimc_subdev_index
{
152 struct media_pipeline
;
155 struct fimc_pipeline
{
156 struct v4l2_subdev
*subdevs
[IDX_MAX
];
157 struct media_pipeline
*m_pipeline
;
161 * Media pipeline operations to be called from within the fimc(-lite)
162 * video node when it is the last entity of the pipeline. Implemented
163 * by corresponding media device driver.
165 struct fimc_pipeline_ops
{
166 int (*open
)(struct fimc_pipeline
*p
, struct media_entity
*me
,
168 int (*close
)(struct fimc_pipeline
*p
);
169 int (*set_stream
)(struct fimc_pipeline
*p
, bool state
);
172 #define fimc_pipeline_call(f, op, p, args...) \
173 (!(f) ? -ENODEV : (((f)->pipeline_ops && (f)->pipeline_ops->op) ? \
174 (f)->pipeline_ops->op((p), ##args) : -ENOIOCTLCMD))
176 #endif /* S5P_FIMC_H_ */