[GitHub/mt8127/android_kernel_alcatel_ttab.git] / include / video / exynos_mipi_dsim.h

/* include/video/exynos_mipi_dsim.h
 *
 * Platform data header for Samsung SoC MIPI-DSIM.
 *
 * Copyright (c) 2012 Samsung Electronics Co., Ltd
 *
 * InKi Dae <inki.dae@samsung.com>
 * Donghwa Lee <dh09.lee@samsung.com>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
*/

#ifndef _EXYNOS_MIPI_DSIM_H
#define _EXYNOS_MIPI_DSIM_H

#include <linux/device.h>
#include <linux/fb.h>

#define PANEL_NAME_SIZE		(32)

/*
 * Enumerate display interface type.
 *
 * DSIM_COMMAND means cpu interface and rgb interface for DSIM_VIDEO.
 *
 * P.S. MIPI DSI Master has two display controller intefaces, RGB Interface
 *	for main display and CPU Interface(same as I80 Interface) for main
 *	and sub display.
 */
enum mipi_dsim_interface_type {
	DSIM_COMMAND,
	DSIM_VIDEO
};

enum mipi_dsim_virtual_ch_no {
	DSIM_VIRTUAL_CH_0,
	DSIM_VIRTUAL_CH_1,
	DSIM_VIRTUAL_CH_2,
	DSIM_VIRTUAL_CH_3
};

enum mipi_dsim_burst_mode_type {
	DSIM_NON_BURST_SYNC_EVENT,
	DSIM_BURST_SYNC_EVENT,
	DSIM_NON_BURST_SYNC_PULSE,
	DSIM_BURST,
	DSIM_NON_VIDEO_MODE
};

enum mipi_dsim_no_of_data_lane {
	DSIM_DATA_LANE_1,
	DSIM_DATA_LANE_2,
	DSIM_DATA_LANE_3,
	DSIM_DATA_LANE_4
};

enum mipi_dsim_byte_clk_src {
	DSIM_PLL_OUT_DIV8,
	DSIM_EXT_CLK_DIV8,
	DSIM_EXT_CLK_BYPASS
};

enum mipi_dsim_pixel_format {
	DSIM_CMD_3BPP,
	DSIM_CMD_8BPP,
	DSIM_CMD_12BPP,
	DSIM_CMD_16BPP,
	DSIM_VID_16BPP_565,
	DSIM_VID_18BPP_666PACKED,
	DSIM_18BPP_666LOOSELYPACKED,
	DSIM_24BPP_888
};

/*
 * struct mipi_dsim_config - interface for configuring mipi-dsi controller.
 *
 * @auto_flush: enable or disable Auto flush of MD FIFO using VSYNC pulse.
 * @eot_disable: enable or disable EoT packet in HS mode.
 * @auto_vertical_cnt: specifies auto vertical count mode.
 *	in Video mode, the vertical line transition uses line counter
 *	configured by VSA, VBP, and Vertical resolution.
 *	If this bit is set to '1', the line counter does not use VSA and VBP
 *	registers.(in command mode, this variable is ignored)
 * @hse: set horizontal sync event mode.
 *	In VSYNC pulse and Vporch area, MIPI DSI master transfers only HSYNC
 *	start packet to MIPI DSI slave at MIPI DSI spec1.1r02.
 *	this bit transfers HSYNC end packet in VSYNC pulse and Vporch area
 *	(in mommand mode, this variable is ignored)
 * @hfp: specifies HFP disable mode.
 *	if this variable is set, DSI master ignores HFP area in VIDEO mode.
 *	(in command mode, this variable is ignored)
 * @hbp: specifies HBP disable mode.
 *	if this variable is set, DSI master ignores HBP area in VIDEO mode.
 *	(in command mode, this variable is ignored)
 * @hsa: specifies HSA disable mode.
 *	if this variable is set, DSI master ignores HSA area in VIDEO mode.
 *	(in command mode, this variable is ignored)
 * @cma_allow: specifies the number of horizontal lines, where command packet
 *	transmission is allowed after Stable VFP period.
 * @e_interface: specifies interface to be used.(CPU or RGB interface)
 * @e_virtual_ch: specifies virtual channel number that main or
 *	sub diaplsy uses.
 * @e_pixel_format: specifies pixel stream format for main or sub display.
 * @e_burst_mode: selects Burst mode in Video mode.
 *	in Non-burst mode, RGB data area is filled with RGB data and NULL
 *	packets, according to input bandwidth of RGB interface.
 *	In Burst mode, RGB data area is filled with RGB data only.
 * @e_no_data_lane: specifies data lane count to be used by Master.
 * @e_byte_clk: select byte clock source. (it must be DSIM_PLL_OUT_DIV8)
 *	DSIM_EXT_CLK_DIV8 and DSIM_EXT_CLK_BYPASSS are not supported.
 * @pll_stable_time: specifies the PLL Timer for stability of the ganerated
 *	clock(System clock cycle base)
 *	if the timer value goes to 0x00000000, the clock stable bit of status
 *	and interrupt register is set.
 * @esc_clk: specifies escape clock frequency for getting the escape clock
 *	prescaler value.
 * @stop_holding_cnt: specifies the interval value between transmitting
 *	read packet(or write "set_tear_on" command) and BTA request.
 *	after transmitting read packet or write "set_tear_on" command,
 *	BTA requests to D-PHY automatically. this counter value specifies
 *	the interval between them.
 * @bta_timeout: specifies the timer for BTA.
 *	this register specifies time out from BTA request to change
 *	the direction with respect to Tx escape clock.
 * @rx_timeout: specifies the timer for LP Rx mode timeout.
 *	this register specifies time out on how long RxValid deasserts,
 *	after RxLpdt asserts with respect to Tx escape clock.
 *	- RxValid specifies Rx data valid indicator.
 *	- RxLpdt specifies an indicator that D-PHY is under RxLpdt mode.
 *	- RxValid and RxLpdt specifies signal from D-PHY.
 */
struct mipi_dsim_config {
	unsigned char			auto_flush;
	unsigned char			eot_disable;

	unsigned char			auto_vertical_cnt;
	unsigned char			hse;
	unsigned char			hfp;
	unsigned char			hbp;
	unsigned char			hsa;
	unsigned char			cmd_allow;

	enum mipi_dsim_interface_type	e_interface;
	enum mipi_dsim_virtual_ch_no	e_virtual_ch;
	enum mipi_dsim_pixel_format	e_pixel_format;
	enum mipi_dsim_burst_mode_type	e_burst_mode;
	enum mipi_dsim_no_of_data_lane	e_no_data_lane;
	enum mipi_dsim_byte_clk_src	e_byte_clk;

	/*
	 * ===========================================
	 * |    P    |    M    |    S    |    MHz    |
	 * -------------------------------------------
	 * |    3    |   100   |    3    |    100    |
	 * |    3    |   100   |    2    |    200    |
	 * |    3    |    63   |    1    |    252    |
	 * |    4    |   100   |    1    |    300    |
	 * |    4    |   110   |    1    |    330    |
	 * |   12    |   350   |    1    |    350    |
	 * |    3    |   100   |    1    |    400    |
	 * |    4    |   150   |    1    |    450    |
	 * |    6    |   118   |    1    |    472    |
	 * |	3    |   120   |    1    |    480    |
	 * |   12    |   250   |    0    |    500    |
	 * |    4    |   100   |    0    |    600    |
	 * |    3    |    81   |    0    |    648    |
	 * |    3    |    88   |    0    |    704    |
	 * |    3    |    90   |    0    |    720    |
	 * |    3    |   100   |    0    |    800    |
	 * |   12    |   425   |    0    |    850    |
	 * |    4    |   150   |    0    |    900    |
	 * |   12    |   475   |    0    |    950    |
	 * |    6    |   250   |    0    |   1000    |
	 * -------------------------------------------
	 */

	/*
	 * pms could be calculated as the following.
	 * M * 24 / P * 2 ^ S = MHz
	 */
	unsigned char			p;
	unsigned short			m;
	unsigned char			s;

	unsigned int			pll_stable_time;
	unsigned long			esc_clk;

	unsigned short			stop_holding_cnt;
	unsigned char			bta_timeout;
	unsigned short			rx_timeout;
};

/*
 * struct mipi_dsim_device - global interface for mipi-dsi driver.
 *
 * @dev: driver model representation of the device.
 * @id: unique device id.
 * @clock: pointer to MIPI-DSI clock of clock framework.
 * @irq: interrupt number to MIPI-DSI controller.
 * @reg_base: base address to memory mapped SRF of MIPI-DSI controller.
 *	(virtual address)
 * @lock: the mutex protecting this data structure.
 * @dsim_info: infomation for configuring mipi-dsi controller.
 * @master_ops: callbacks to mipi-dsi operations.
 * @dsim_lcd_dev: pointer to activated ddi device.
 *	(it would be registered by mipi-dsi driver.)
 * @dsim_lcd_drv: pointer to activated_ddi driver.
 *	(it would be registered by mipi-dsi driver.)
 * @lcd_info: pointer to mipi_lcd_info structure.
 * @state: specifies status of MIPI-DSI controller.
 *	the status could be RESET, INIT, STOP, HSCLKEN and ULPS.
 * @data_lane: specifiec enabled data lane number.
 *	this variable would be set by driver according to e_no_data_lane
 *	automatically.
 * @e_clk_src: select byte clock source.
 * @pd: pointer to MIPI-DSI driver platform data.
 */
struct mipi_dsim_device {
	struct device			*dev;
	int				id;
	struct clk			*clock;
	unsigned int			irq;
	void __iomem			*reg_base;
	struct mutex			lock;

	struct mipi_dsim_config		*dsim_config;
	struct mipi_dsim_master_ops	*master_ops;
	struct mipi_dsim_lcd_device	*dsim_lcd_dev;
	struct mipi_dsim_lcd_driver	*dsim_lcd_drv;

	unsigned int			state;
	unsigned int			data_lane;
	unsigned int			e_clk_src;
	bool				suspended;

	struct mipi_dsim_platform_data	*pd;
};

/*
 * struct mipi_dsim_platform_data - interface to platform data
 *	for mipi-dsi driver.
 *
 * @lcd_panel_name: specifies lcd panel name registered to mipi-dsi driver.
 *	lcd panel driver searched would be actived.
 * @dsim_config: pointer of structure for configuring mipi-dsi controller.
 * @enabled: indicate whether mipi controller got enabled or not.
 * @lcd_panel_info: pointer for lcd panel specific structure.
 *	this structure specifies width, height, timing and polarity and so on.
 * @phy_enable: pointer to a callback controlling D-PHY enable/reset
 */
struct mipi_dsim_platform_data {
	char				lcd_panel_name[PANEL_NAME_SIZE];

	struct mipi_dsim_config		*dsim_config;
	unsigned int			enabled;
	void				*lcd_panel_info;

	int (*phy_enable)(struct platform_device *pdev, bool on);
};

/*
 * struct mipi_dsim_master_ops - callbacks to mipi-dsi operations.
 *
 * @cmd_write: transfer command to lcd panel at LP mode.
 * @cmd_read: read command from rx register.
 * @get_dsim_frame_done: get the status that all screen data have been
 *	transferred to mipi-dsi.
 * @clear_dsim_frame_done: clear frame done status.
 * @get_fb_frame_done: get frame done status of display controller.
 * @trigger: trigger display controller.
 *	- this one would be used only in case of CPU mode.
 *  @set_early_blank_mode: set framebuffer blank mode.
 *	- this callback should be called prior to fb_blank() by a client driver
 *	only if needing.
 *  @set_blank_mode: set framebuffer blank mode.
 *	- this callback should be called after fb_blank() by a client driver
 *	only if needing.
 */

struct mipi_dsim_master_ops {
	int (*cmd_write)(struct mipi_dsim_device *dsim, unsigned int data_id,
		const unsigned char *data0, unsigned int data1);
	int (*cmd_read)(struct mipi_dsim_device *dsim, unsigned int data_id,
		unsigned int data0, unsigned int req_size, u8 *rx_buf);
	int (*get_dsim_frame_done)(struct mipi_dsim_device *dsim);
	int (*clear_dsim_frame_done)(struct mipi_dsim_device *dsim);

	int (*get_fb_frame_done)(struct fb_info *info);
	void (*trigger)(struct fb_info *info);
	int (*set_early_blank_mode)(struct mipi_dsim_device *dsim, int power);
	int (*set_blank_mode)(struct mipi_dsim_device *dsim, int power);
};

/*
 * device structure for mipi-dsi based lcd panel.
 *
 * @name: name of the device to use with this device, or an
 *	alias for that name.
 * @dev: driver model representation of the device.
 * @id: id of device to be registered.
 * @bus_id: bus id for identifing connected bus
 *	and this bus id should be same as id of mipi_dsim_device.
 * @irq: irq number for signaling when framebuffer transfer of
 *	lcd panel module is completed.
 *	this irq would be used only for MIPI-DSI based CPU mode lcd panel.
 * @master: pointer to mipi-dsi master device object.
 * @platform_data: lcd panel specific platform data.
 */
struct mipi_dsim_lcd_device {
	char			*name;
	struct device		dev;
	int			id;
	int			bus_id;
	int			irq;
	int			panel_reverse;

	struct mipi_dsim_device *master;
	void			*platform_data;
};

/*
 * driver structure for mipi-dsi based lcd panel.
 *
 * this structure should be registered by lcd panel driver.
 * mipi-dsi driver seeks lcd panel registered through name field
 * and calls these callback functions in appropriate time.
 *
 * @name: name of the driver to use with this device, or an
 *	alias for that name.
 * @id: id of driver to be registered.
 *	this id would be used for finding device object registered.
 */
struct mipi_dsim_lcd_driver {
	char			*name;
	int			id;

	void	(*power_on)(struct mipi_dsim_lcd_device *dsim_dev, int enable);
	void	(*set_sequence)(struct mipi_dsim_lcd_device *dsim_dev);
	int	(*probe)(struct mipi_dsim_lcd_device *dsim_dev);
	int	(*remove)(struct mipi_dsim_lcd_device *dsim_dev);
	void	(*shutdown)(struct mipi_dsim_lcd_device *dsim_dev);
	int	(*suspend)(struct mipi_dsim_lcd_device *dsim_dev);
	int	(*resume)(struct mipi_dsim_lcd_device *dsim_dev);
};

/*
 * register mipi_dsim_lcd_device to mipi-dsi master.
 */
int exynos_mipi_dsi_register_lcd_device(struct mipi_dsim_lcd_device
						*lcd_dev);
/**
 * register mipi_dsim_lcd_driver object defined by lcd panel driver
 * to mipi-dsi driver.
 */
int exynos_mipi_dsi_register_lcd_driver(struct mipi_dsim_lcd_driver
						*lcd_drv);
#endif /* _EXYNOS_MIPI_DSIM_H */
Commit	Line	Data
7258cc14 DL	1	/* include/video/exynos_mipi_dsim.h
	2	*
	3	* Platform data header for Samsung SoC MIPI-DSIM.
	4	*
	5	* Copyright (c) 2012 Samsung Electronics Co., Ltd
	6	*
	7	* InKi Dae <inki.dae@samsung.com>
	8	* Donghwa Lee <dh09.lee@samsung.com>
	9	*
	10	* This program is free software; you can redistribute it and/or modify
	11	* it under the terms of the GNU General Public License version 2 as
	12	* published by the Free Software Foundation.
	13	*/
	14
	15	#ifndef _EXYNOS_MIPI_DSIM_H
	16	#define _EXYNOS_MIPI_DSIM_H
	17
	18	#include <linux/device.h>
	19	#include <linux/fb.h>
	20
	21	#define PANEL_NAME_SIZE (32)
	22
	23	/*
	24	* Enumerate display interface type.
	25	*
	26	* DSIM_COMMAND means cpu interface and rgb interface for DSIM_VIDEO.
	27	*
	28	* P.S. MIPI DSI Master has two display controller intefaces, RGB Interface
	29	* for main display and CPU Interface(same as I80 Interface) for main
	30	* and sub display.
	31	*/
	32	enum mipi_dsim_interface_type {
	33	DSIM_COMMAND,
	34	DSIM_VIDEO
	35	};
	36
	37	enum mipi_dsim_virtual_ch_no {
	38	DSIM_VIRTUAL_CH_0,
	39	DSIM_VIRTUAL_CH_1,
	40	DSIM_VIRTUAL_CH_2,
	41	DSIM_VIRTUAL_CH_3
	42	};
	43
	44	enum mipi_dsim_burst_mode_type {
	45	DSIM_NON_BURST_SYNC_EVENT,
	46	DSIM_BURST_SYNC_EVENT,
	47	DSIM_NON_BURST_SYNC_PULSE,
	48	DSIM_BURST,
	49	DSIM_NON_VIDEO_MODE
	50	};
	51
	52	enum mipi_dsim_no_of_data_lane {
	53	DSIM_DATA_LANE_1,
	54	DSIM_DATA_LANE_2,
	55	DSIM_DATA_LANE_3,
	56	DSIM_DATA_LANE_4
	57	};
	58
	59	enum mipi_dsim_byte_clk_src {
	60	DSIM_PLL_OUT_DIV8,
	61	DSIM_EXT_CLK_DIV8,
	62	DSIM_EXT_CLK_BYPASS
	63	};
	64
65	enum mipi_dsim_pixel_format {
66	DSIM_CMD_3BPP,
67	DSIM_CMD_8BPP,
68	DSIM_CMD_12BPP,
69	DSIM_CMD_16BPP,
70	DSIM_VID_16BPP_565,
71	DSIM_VID_18BPP_666PACKED,
72	DSIM_18BPP_666LOOSELYPACKED,
73	DSIM_24BPP_888
74	};
75
76	/*
77	* struct mipi_dsim_config - interface for configuring mipi-dsi controller.
78	*
79	* @auto_flush: enable or disable Auto flush of MD FIFO using VSYNC pulse.
80	* @eot_disable: enable or disable EoT packet in HS mode.
81	* @auto_vertical_cnt: specifies auto vertical count mode.
82	* in Video mode, the vertical line transition uses line counter
83	* configured by VSA, VBP, and Vertical resolution.
84	* If this bit is set to '1', the line counter does not use VSA and VBP
85	* registers.(in command mode, this variable is ignored)
86	* @hse: set horizontal sync event mode.
87	* In VSYNC pulse and Vporch area, MIPI DSI master transfers only HSYNC
88	* start packet to MIPI DSI slave at MIPI DSI spec1.1r02.
89	* this bit transfers HSYNC end packet in VSYNC pulse and Vporch area
90	* (in mommand mode, this variable is ignored)
91	* @hfp: specifies HFP disable mode.
92	* if this variable is set, DSI master ignores HFP area in VIDEO mode.
93	* (in command mode, this variable is ignored)
94	* @hbp: specifies HBP disable mode.
95	* if this variable is set, DSI master ignores HBP area in VIDEO mode.
96	* (in command mode, this variable is ignored)
97	* @hsa: specifies HSA disable mode.
98	* if this variable is set, DSI master ignores HSA area in VIDEO mode.
99	* (in command mode, this variable is ignored)
100	* @cma_allow: specifies the number of horizontal lines, where command packet
101	* transmission is allowed after Stable VFP period.
102	* @e_interface: specifies interface to be used.(CPU or RGB interface)
103	* @e_virtual_ch: specifies virtual channel number that main or
104	* sub diaplsy uses.
105	* @e_pixel_format: specifies pixel stream format for main or sub display.
106	* @e_burst_mode: selects Burst mode in Video mode.
107	* in Non-burst mode, RGB data area is filled with RGB data and NULL
108	* packets, according to input bandwidth of RGB interface.
109	* In Burst mode, RGB data area is filled with RGB data only.
110	* @e_no_data_lane: specifies data lane count to be used by Master.
111	* @e_byte_clk: select byte clock source. (it must be DSIM_PLL_OUT_DIV8)
112	* DSIM_EXT_CLK_DIV8 and DSIM_EXT_CLK_BYPASSS are not supported.
113	* @pll_stable_time: specifies the PLL Timer for stability of the ganerated
114	* clock(System clock cycle base)
115	* if the timer value goes to 0x00000000, the clock stable bit of status
116	* and interrupt register is set.
117	* @esc_clk: specifies escape clock frequency for getting the escape clock
118	* prescaler value.
119	* @stop_holding_cnt: specifies the interval value between transmitting
120	* read packet(or write "set_tear_on" command) and BTA request.
121	* after transmitting read packet or write "set_tear_on" command,
122	* BTA requests to D-PHY automatically. this counter value specifies
123	* the interval between them.
124	* @bta_timeout: specifies the timer for BTA.
125	* this register specifies time out from BTA request to change
126	* the direction with respect to Tx escape clock.
127	* @rx_timeout: specifies the timer for LP Rx mode timeout.
128	* this register specifies time out on how long RxValid deasserts,
129	* after RxLpdt asserts with respect to Tx escape clock.
130	* - RxValid specifies Rx data valid indicator.
131	* - RxLpdt specifies an indicator that D-PHY is under RxLpdt mode.
132	* - RxValid and RxLpdt specifies signal from D-PHY.
133	*/
134	struct mipi_dsim_config {
135	unsigned char auto_flush;
136	unsigned char eot_disable;
137
138	unsigned char auto_vertical_cnt;
139	unsigned char hse;
140	unsigned char hfp;
141	unsigned char hbp;
142	unsigned char hsa;
143	unsigned char cmd_allow;
144
145	enum mipi_dsim_interface_type e_interface;
146	enum mipi_dsim_virtual_ch_no e_virtual_ch;
147	enum mipi_dsim_pixel_format e_pixel_format;
148	enum mipi_dsim_burst_mode_type e_burst_mode;
149	enum mipi_dsim_no_of_data_lane e_no_data_lane;
150	enum mipi_dsim_byte_clk_src e_byte_clk;
151
152	/*
153	* ===========================================
154	* \| P \| M \| S \| MHz \|
155	* -------------------------------------------
156	* \| 3 \| 100 \| 3 \| 100 \|
157	* \| 3 \| 100 \| 2 \| 200 \|
158	* \| 3 \| 63 \| 1 \| 252 \|
159	* \| 4 \| 100 \| 1 \| 300 \|
160	* \| 4 \| 110 \| 1 \| 330 \|
161	* \| 12 \| 350 \| 1 \| 350 \|
162	* \| 3 \| 100 \| 1 \| 400 \|
163	* \| 4 \| 150 \| 1 \| 450 \|
164	* \| 6 \| 118 \| 1 \| 472 \|
165	* \| 3 \| 120 \| 1 \| 480 \|
166	* \| 12 \| 250 \| 0 \| 500 \|
167	* \| 4 \| 100 \| 0 \| 600 \|
168	* \| 3 \| 81 \| 0 \| 648 \|
169	* \| 3 \| 88 \| 0 \| 704 \|
170	* \| 3 \| 90 \| 0 \| 720 \|
171	* \| 3 \| 100 \| 0 \| 800 \|
172	* \| 12 \| 425 \| 0 \| 850 \|
173	* \| 4 \| 150 \| 0 \| 900 \|
174	* \| 12 \| 475 \| 0 \| 950 \|
175	* \| 6 \| 250 \| 0 \| 1000 \|
176	* -------------------------------------------
177	*/
178
179	/*
180	* pms could be calculated as the following.
181	* M * 24 / P * 2 ^ S = MHz
182	*/
183	unsigned char p;
184	unsigned short m;
185	unsigned char s;
186
187	unsigned int pll_stable_time;
188	unsigned long esc_clk;
189
190	unsigned short stop_holding_cnt;
191	unsigned char bta_timeout;
192	unsigned short rx_timeout;
193	};
194
195	/*
196	* struct mipi_dsim_device - global interface for mipi-dsi driver.
197	*
198	* @dev: driver model representation of the device.
199	* @id: unique device id.
200	* @clock: pointer to MIPI-DSI clock of clock framework.
201	* @irq: interrupt number to MIPI-DSI controller.
202	* @reg_base: base address to memory mapped SRF of MIPI-DSI controller.
203	* (virtual address)
204	* @lock: the mutex protecting this data structure.
205	* @dsim_info: infomation for configuring mipi-dsi controller.
206	* @master_ops: callbacks to mipi-dsi operations.
207	* @dsim_lcd_dev: pointer to activated ddi device.
208	* (it would be registered by mipi-dsi driver.)
209	* @dsim_lcd_drv: pointer to activated_ddi driver.
210	* (it would be registered by mipi-dsi driver.)
211	* @lcd_info: pointer to mipi_lcd_info structure.
212	* @state: specifies status of MIPI-DSI controller.
213	* the status could be RESET, INIT, STOP, HSCLKEN and ULPS.
214	* @data_lane: specifiec enabled data lane number.
215	* this variable would be set by driver according to e_no_data_lane
216	* automatically.
217	* @e_clk_src: select byte clock source.
218	* @pd: pointer to MIPI-DSI driver platform data.
219	*/
220	struct mipi_dsim_device {
221	struct device *dev;
222	int id;
7258cc14 DL	223	struct clk *clock;
	224	unsigned int irq;
	225	void __iomem *reg_base;
	226	struct mutex lock;
	227
	228	struct mipi_dsim_config *dsim_config;
	229	struct mipi_dsim_master_ops *master_ops;
	230	struct mipi_dsim_lcd_device *dsim_lcd_dev;
	231	struct mipi_dsim_lcd_driver *dsim_lcd_drv;
	232
	233	unsigned int state;
	234	unsigned int data_lane;
	235	unsigned int e_clk_src;
	236	bool suspended;
	237
	238	struct mipi_dsim_platform_data *pd;
	239	};
	240
	241	/*
	242	* struct mipi_dsim_platform_data - interface to platform data
	243	* for mipi-dsi driver.
	244	*
	245	* @lcd_panel_name: specifies lcd panel name registered to mipi-dsi driver.
	246	* lcd panel driver searched would be actived.
	247	* @dsim_config: pointer of structure for configuring mipi-dsi controller.
	248	* @enabled: indicate whether mipi controller got enabled or not.
	249	* @lcd_panel_info: pointer for lcd panel specific structure.
	250	* this structure specifies width, height, timing and polarity and so on.
	251	* @phy_enable: pointer to a callback controlling D-PHY enable/reset
	252	*/
	253	struct mipi_dsim_platform_data {
	254	char lcd_panel_name[PANEL_NAME_SIZE];
	255
	256	struct mipi_dsim_config *dsim_config;
	257	unsigned int enabled;
	258	void *lcd_panel_info;
	259
	260	int (phy_enable)(struct platform_device pdev, bool on);
	261	};
	262
	263	/*
	264	* struct mipi_dsim_master_ops - callbacks to mipi-dsi operations.
	265	*
	266	* @cmd_write: transfer command to lcd panel at LP mode.
	267	* @cmd_read: read command from rx register.
	268	* @get_dsim_frame_done: get the status that all screen data have been
	269	* transferred to mipi-dsi.
	270	* @clear_dsim_frame_done: clear frame done status.
	271	* @get_fb_frame_done: get frame done status of display controller.
	272	* @trigger: trigger display controller.
	273	* - this one would be used only in case of CPU mode.
	274	* @set_early_blank_mode: set framebuffer blank mode.
	275	* - this callback should be called prior to fb_blank() by a client driver
	276	* only if needing.
	277	* @set_blank_mode: set framebuffer blank mode.
	278	* - this callback should be called after fb_blank() by a client driver
	279	* only if needing.
	280	*/
	281
	282	struct mipi_dsim_master_ops {
	283	int (cmd_write)(struct mipi_dsim_device dsim, unsigned int data_id,
	284	const unsigned char *data0, unsigned int data1);
	285	int (cmd_read)(struct mipi_dsim_device dsim, unsigned int data_id,
	286	unsigned int data0, unsigned int req_size, u8 *rx_buf);
287	int (get_dsim_frame_done)(struct mipi_dsim_device dsim);
288	int (clear_dsim_frame_done)(struct mipi_dsim_device dsim);
289
290	int (get_fb_frame_done)(struct fb_info info);
291	void (trigger)(struct fb_info info);
292	int (set_early_blank_mode)(struct mipi_dsim_device dsim, int power);
293	int (set_blank_mode)(struct mipi_dsim_device dsim, int power);
294	};
295
296	/*
297	* device structure for mipi-dsi based lcd panel.
298	*
299	* @name: name of the device to use with this device, or an
300	* alias for that name.
301	* @dev: driver model representation of the device.
302	* @id: id of device to be registered.
303	* @bus_id: bus id for identifing connected bus
304	* and this bus id should be same as id of mipi_dsim_device.
305	* @irq: irq number for signaling when framebuffer transfer of
306	* lcd panel module is completed.
307	* this irq would be used only for MIPI-DSI based CPU mode lcd panel.
308	* @master: pointer to mipi-dsi master device object.
309	* @platform_data: lcd panel specific platform data.
310	*/
311	struct mipi_dsim_lcd_device {
312	char *name;
313	struct device dev;
314	int id;
315	int bus_id;
316	int irq;
24bb7a6e	317	int panel_reverse;
7258cc14 DL	318
	319	struct mipi_dsim_device *master;
	320	void *platform_data;
	321	};
	322
	323	/*
	324	* driver structure for mipi-dsi based lcd panel.
	325	*
	326	* this structure should be registered by lcd panel driver.
	327	* mipi-dsi driver seeks lcd panel registered through name field
	328	* and calls these callback functions in appropriate time.
	329	*
	330	* @name: name of the driver to use with this device, or an
	331	* alias for that name.
	332	* @id: id of driver to be registered.
	333	* this id would be used for finding device object registered.
	334	*/
	335	struct mipi_dsim_lcd_driver {
	336	char *name;
	337	int id;
	338
	339	void (power_on)(struct mipi_dsim_lcd_device dsim_dev, int enable);
	340	void (set_sequence)(struct mipi_dsim_lcd_device dsim_dev);
	341	int (probe)(struct mipi_dsim_lcd_device dsim_dev);
	342	int (remove)(struct mipi_dsim_lcd_device dsim_dev);
	343	void (shutdown)(struct mipi_dsim_lcd_device dsim_dev);
	344	int (suspend)(struct mipi_dsim_lcd_device dsim_dev);
	345	int (resume)(struct mipi_dsim_lcd_device dsim_dev);
	346	};
	347
	348	/*
	349	* register mipi_dsim_lcd_device to mipi-dsi master.
	350	*/
	351	int exynos_mipi_dsi_register_lcd_device(struct mipi_dsim_lcd_device
	352	*lcd_dev);
	353	/**
	354	* register mipi_dsim_lcd_driver object defined by lcd panel driver
	355	* to mipi-dsi driver.
	356	*/
	357	int exynos_mipi_dsi_register_lcd_driver(struct mipi_dsim_lcd_driver
	358	*lcd_drv);
	359	#endif /* _EXYNOS_MIPI_DSIM_H */