xref: /linux/drivers/video/fbdev/omap/omapfb.h (revision ca55b2fef3a9373fcfc30f82fd26bc7fccbda732)
1 /*
2  * File: drivers/video/omap/omapfb.h
3  *
4  * Framebuffer driver for TI OMAP boards
5  *
6  * Copyright (C) 2004 Nokia Corporation
7  * Author: Imre Deak <imre.deak@nokia.com>
8  *
9  * This program is free software; you can redistribute it and/or modify it
10  * under the terms of the GNU General Public License as published by the
11  * Free Software Foundation; either version 2 of the License, or (at your
12  * option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful, but
15  * WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17  * General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License along
20  * with this program; if not, write to the Free Software Foundation, Inc.,
21  * 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
22  */
23 
24 #ifndef __OMAPFB_H
25 #define __OMAPFB_H
26 
27 #include <linux/fb.h>
28 #include <linux/mutex.h>
29 #include <linux/omapfb.h>
30 
31 #define OMAPFB_EVENT_READY	1
32 #define OMAPFB_EVENT_DISABLED	2
33 
34 #define OMAP_LCDC_INV_VSYNC             0x0001
35 #define OMAP_LCDC_INV_HSYNC             0x0002
36 #define OMAP_LCDC_INV_PIX_CLOCK         0x0004
37 #define OMAP_LCDC_INV_OUTPUT_EN         0x0008
38 #define OMAP_LCDC_HSVS_RISING_EDGE      0x0010
39 #define OMAP_LCDC_HSVS_OPPOSITE         0x0020
40 
41 #define OMAP_LCDC_SIGNAL_MASK		0x003f
42 
43 #define OMAP_LCDC_PANEL_TFT		0x0100
44 
45 #define OMAPFB_PLANE_XRES_MIN		8
46 #define OMAPFB_PLANE_YRES_MIN		8
47 
48 struct omapfb_device;
49 
50 #define OMAPFB_PLANE_NUM		1
51 
52 struct omapfb_mem_region {
53 	u32		paddr;
54 	void __iomem	*vaddr;
55 	unsigned long	size;
56 	u8		type;		/* OMAPFB_PLANE_MEM_* */
57 	enum omapfb_color_format format;/* OMAPFB_COLOR_* */
58 	unsigned	format_used:1;	/* Must be set when format is set.
59 					 * Needed b/c of the badly chosen 0
60 					 * base for OMAPFB_COLOR_* values
61 					 */
62 	unsigned	alloc:1;	/* allocated by the driver */
63 	unsigned	map:1;		/* kernel mapped by the driver */
64 };
65 
66 struct omapfb_mem_desc {
67 	int				region_cnt;
68 	struct omapfb_mem_region	region[OMAPFB_PLANE_NUM];
69 };
70 
71 struct lcd_panel {
72 	const char	*name;
73 	int		config;		/* TFT/STN, signal inversion */
74 	int		bpp;		/* Pixel format in fb mem */
75 	int		data_lines;	/* Lines on LCD HW interface */
76 
77 	int		x_res, y_res;
78 	int		pixel_clock;	/* In kHz */
79 	int		hsw;		/* Horizontal synchronization
80 					   pulse width */
81 	int		hfp;		/* Horizontal front porch */
82 	int		hbp;		/* Horizontal back porch */
83 	int		vsw;		/* Vertical synchronization
84 					   pulse width */
85 	int		vfp;		/* Vertical front porch */
86 	int		vbp;		/* Vertical back porch */
87 	int		acb;		/* ac-bias pin frequency */
88 	int		pcd;		/* pixel clock divider.
89 					   Obsolete use pixel_clock instead */
90 
91 	int		(*init)		(struct lcd_panel *panel,
92 					 struct omapfb_device *fbdev);
93 	void		(*cleanup)	(struct lcd_panel *panel);
94 	int		(*enable)	(struct lcd_panel *panel);
95 	void		(*disable)	(struct lcd_panel *panel);
96 	unsigned long	(*get_caps)	(struct lcd_panel *panel);
97 	int		(*set_bklight_level)(struct lcd_panel *panel,
98 					     unsigned int level);
99 	unsigned int	(*get_bklight_level)(struct lcd_panel *panel);
100 	unsigned int	(*get_bklight_max)  (struct lcd_panel *panel);
101 	int		(*run_test)	(struct lcd_panel *panel, int test_num);
102 };
103 
104 struct extif_timings {
105 	int cs_on_time;
106 	int cs_off_time;
107 	int we_on_time;
108 	int we_off_time;
109 	int re_on_time;
110 	int re_off_time;
111 	int we_cycle_time;
112 	int re_cycle_time;
113 	int cs_pulse_width;
114 	int access_time;
115 
116 	int clk_div;
117 
118 	u32 tim[5];		/* set by extif->convert_timings */
119 
120 	int converted;
121 };
122 
123 struct lcd_ctrl_extif {
124 	int  (*init)		(struct omapfb_device *fbdev);
125 	void (*cleanup)		(void);
126 	void (*get_clk_info)	(u32 *clk_period, u32 *max_clk_div);
127 	unsigned long (*get_max_tx_rate)(void);
128 	int  (*convert_timings)	(struct extif_timings *timings);
129 	void (*set_timings)	(const struct extif_timings *timings);
130 	void (*set_bits_per_cycle)(int bpc);
131 	void (*write_command)	(const void *buf, unsigned int len);
132 	void (*read_data)	(void *buf, unsigned int len);
133 	void (*write_data)	(const void *buf, unsigned int len);
134 	void (*transfer_area)	(int width, int height,
135 				 void (callback)(void *data), void *data);
136 	int  (*setup_tearsync)	(unsigned pin_cnt,
137 				 unsigned hs_pulse_time, unsigned vs_pulse_time,
138 				 int hs_pol_inv, int vs_pol_inv, int div);
139 	int  (*enable_tearsync) (int enable, unsigned line);
140 
141 	unsigned long		max_transmit_size;
142 };
143 
144 struct omapfb_notifier_block {
145 	struct notifier_block	nb;
146 	void			*data;
147 	int			plane_idx;
148 };
149 
150 typedef int (*omapfb_notifier_callback_t)(struct notifier_block *,
151 					  unsigned long event,
152 					  void *fbi);
153 
154 struct lcd_ctrl {
155 	const char	*name;
156 	void		*data;
157 
158 	int		(*init)		  (struct omapfb_device *fbdev,
159 					   int ext_mode,
160 					   struct omapfb_mem_desc *req_md);
161 	void		(*cleanup)	  (void);
162 	void		(*bind_client)	  (struct omapfb_notifier_block *nb);
163 	void		(*get_caps)	  (int plane, struct omapfb_caps *caps);
164 	int		(*set_update_mode)(enum omapfb_update_mode mode);
165 	enum omapfb_update_mode (*get_update_mode)(void);
166 	int		(*setup_plane)	  (int plane, int channel_out,
167 					   unsigned long offset,
168 					   int screen_width,
169 					   int pos_x, int pos_y, int width,
170 					   int height, int color_mode);
171 	int		(*set_rotate)	  (int angle);
172 	int		(*setup_mem)	  (int plane, size_t size,
173 					   int mem_type, unsigned long *paddr);
174 	int		(*mmap)		  (struct fb_info *info,
175 					   struct vm_area_struct *vma);
176 	int		(*set_scale)	  (int plane,
177 					   int orig_width, int orig_height,
178 					   int out_width, int out_height);
179 	int		(*enable_plane)	  (int plane, int enable);
180 	int		(*update_window)  (struct fb_info *fbi,
181 					   struct omapfb_update_window *win,
182 					   void (*callback)(void *),
183 					   void *callback_data);
184 	void		(*sync)		  (void);
185 	void		(*suspend)	  (void);
186 	void		(*resume)	  (void);
187 	int		(*run_test)	  (int test_num);
188 	int		(*setcolreg)	  (u_int regno, u16 red, u16 green,
189 					   u16 blue, u16 transp,
190 					   int update_hw_mem);
191 	int		(*set_color_key)  (struct omapfb_color_key *ck);
192 	int		(*get_color_key)  (struct omapfb_color_key *ck);
193 };
194 
195 enum omapfb_state {
196 	OMAPFB_DISABLED		= 0,
197 	OMAPFB_SUSPENDED	= 99,
198 	OMAPFB_ACTIVE		= 100
199 };
200 
201 struct omapfb_plane_struct {
202 	int				idx;
203 	struct omapfb_plane_info	info;
204 	enum omapfb_color_format	color_mode;
205 	struct omapfb_device		*fbdev;
206 };
207 
208 struct omapfb_device {
209 	int			state;
210 	int                     ext_lcdc;		/* Using external
211 							   LCD controller */
212 	struct mutex		rqueue_mutex;
213 
214 	int			palette_size;
215 	u32			pseudo_palette[17];
216 
217 	struct lcd_panel	*panel;			/* LCD panel */
218 	const struct lcd_ctrl	*ctrl;			/* LCD controller */
219 	const struct lcd_ctrl	*int_ctrl;		/* internal LCD ctrl */
220 	struct lcd_ctrl_extif	*ext_if;		/* LCD ctrl external
221 							   interface */
222 	struct device		*dev;
223 	struct fb_var_screeninfo	new_var;	/* for mode changes */
224 
225 	struct omapfb_mem_desc		mem_desc;
226 	struct fb_info			*fb_info[OMAPFB_PLANE_NUM];
227 
228 	struct platform_device	*dssdev;	/* dummy dev for clocks */
229 };
230 
231 extern struct lcd_ctrl omap1_lcd_ctrl;
232 
233 extern void omapfb_register_panel(struct lcd_panel *panel);
234 extern void omapfb_write_first_pixel(struct omapfb_device *fbdev, u16 pixval);
235 extern void omapfb_notify_clients(struct omapfb_device *fbdev,
236 				  unsigned long event);
237 extern int  omapfb_register_client(struct omapfb_notifier_block *nb,
238 				   omapfb_notifier_callback_t callback,
239 				   void *callback_data);
240 extern int  omapfb_unregister_client(struct omapfb_notifier_block *nb);
241 extern int  omapfb_update_window_async(struct fb_info *fbi,
242 				       struct omapfb_update_window *win,
243 				       void (*callback)(void *),
244 				       void *callback_data);
245 
246 #endif /* __OMAPFB_H */
247