parisc: Use long branch to do_syscall_trace_exit
[linux-2.6-block.git] / include / drm / drm_fb_helper.h
CommitLineData
785b93ef
DA
1/*
2 * Copyright (c) 2006-2009 Red Hat Inc.
3 * Copyright (c) 2006-2008 Intel Corporation
4 * Copyright (c) 2007 Dave Airlie <airlied@linux.ie>
5 *
6 * DRM framebuffer helper functions
7 *
8 * Permission to use, copy, modify, distribute, and sell this software and its
9 * documentation for any purpose is hereby granted without fee, provided that
10 * the above copyright notice appear in all copies and that both that copyright
11 * notice and this permission notice appear in supporting documentation, and
12 * that the name of the copyright holders not be used in advertising or
13 * publicity pertaining to distribution of the software without specific,
14 * written prior permission. The copyright holders make no representations
15 * about the suitability of this software for any purpose. It is provided "as
16 * is" without express or implied warranty.
17 *
18 * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
19 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
20 * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
21 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
22 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
23 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
24 * OF THIS SOFTWARE.
25 *
26 * Authors:
27 * Dave Airlie <airlied@linux.ie>
28 * Jesse Barnes <jesse.barnes@intel.com>
29 */
30#ifndef DRM_FB_HELPER_H
31#define DRM_FB_HELPER_H
32
4abe3520
DA
33struct drm_fb_helper;
34
1a7aba7f
JB
35#include <linux/kgdb.h>
36
b0ee9e7f
DA
37struct drm_fb_offset {
38 int x, y;
39};
40
785b93ef 41struct drm_fb_helper_crtc {
785b93ef 42 struct drm_mode_set mode_set;
8be48d92 43 struct drm_display_mode *desired_mode;
b0ee9e7f 44 int x, y;
785b93ef
DA
45};
46
b7b5ee59
RC
47/**
48 * struct drm_fb_helper_surface_size - describes fbdev size and scanout surface size
49 * @fb_width: fbdev width
50 * @fb_height: fbdev height
51 * @surface_width: scanout buffer width
52 * @surface_height: scanout buffer height
53 * @surface_bpp: scanout buffer bpp
54 * @surface_depth: scanout buffer depth
55 *
56 * Note that the scanout surface width/height may be larger than the fbdev
57 * width/height. In case of multiple displays, the scanout surface is sized
58 * according to the largest width/height (so it is large enough for all CRTCs
59 * to scanout). But the fbdev width/height is sized to the minimum width/
60 * height of all the displays. This ensures that fbcon fits on the smallest
61 * of the attached displays.
62 *
63 * So what is passed to drm_fb_helper_fill_var() should be fb_width/fb_height,
64 * rather than the surface size.
65 */
38651674
DA
66struct drm_fb_helper_surface_size {
67 u32 fb_width;
68 u32 fb_height;
69 u32 surface_width;
70 u32 surface_height;
71 u32 surface_bpp;
72 u32 surface_depth;
73};
74
207fd329
DV
75/**
76 * struct drm_fb_helper_funcs - driver callbacks for the fbdev emulation library
7b97936f
VS
77 * @gamma_set: Set the given gamma lut register on the given crtc.
78 * @gamma_get: Read the given gamma lut register on the given crtc, used to
79 * save the current lut when force-restoring the fbdev for e.g.
80 * kdbg.
81 * @fb_probe: Driver callback to allocate and initialize the fbdev info
e227867f 82 * structure. Furthermore it also needs to allocate the drm
7b97936f
VS
83 * framebuffer used to back the fbdev.
84 * @initial_config: Setup an initial fbdev display configuration
207fd329
DV
85 *
86 * Driver callbacks used by the fbdev emulation helper library.
87 */
4abe3520
DA
88struct drm_fb_helper_funcs {
89 void (*gamma_set)(struct drm_crtc *crtc, u16 red, u16 green,
90 u16 blue, int regno);
91 void (*gamma_get)(struct drm_crtc *crtc, u16 *red, u16 *green,
92 u16 *blue, int regno);
93
94 int (*fb_probe)(struct drm_fb_helper *helper,
95 struct drm_fb_helper_surface_size *sizes);
11e17a08
JB
96 bool (*initial_config)(struct drm_fb_helper *fb_helper,
97 struct drm_fb_helper_crtc **crtcs,
98 struct drm_display_mode **modes,
b0ee9e7f 99 struct drm_fb_offset *offsets,
11e17a08 100 bool *enabled, int width, int height);
4abe3520
DA
101};
102
d50ba256 103struct drm_fb_helper_connector {
0b4c0f3f 104 struct drm_connector *connector;
d50ba256
DA
105};
106
785b93ef
DA
107struct drm_fb_helper {
108 struct drm_framebuffer *fb;
109 struct drm_device *dev;
785b93ef
DA
110 int crtc_count;
111 struct drm_fb_helper_crtc *crtc_info;
0b4c0f3f 112 int connector_count;
65c2a89c 113 int connector_info_alloc_count;
0b4c0f3f 114 struct drm_fb_helper_connector **connector_info;
3a493879 115 const struct drm_fb_helper_funcs *funcs;
38651674
DA
116 struct fb_info *fbdev;
117 u32 pseudo_palette[17];
785b93ef 118 struct list_head kernel_fb_list;
8be48d92 119
4abe3520
DA
120 /* we got a hotplug but fbdev wasn't running the console
121 delay until next set_par */
122 bool delayed_hotplug;
785b93ef
DA
123};
124
a03fdcb1 125#ifdef CONFIG_DRM_FBDEV_EMULATION
10a23102
TR
126void drm_fb_helper_prepare(struct drm_device *dev, struct drm_fb_helper *helper,
127 const struct drm_fb_helper_funcs *funcs);
4abe3520
DA
128int drm_fb_helper_init(struct drm_device *dev,
129 struct drm_fb_helper *helper, int crtc_count,
eb1f8e4f 130 int max_conn);
4abe3520 131void drm_fb_helper_fini(struct drm_fb_helper *helper);
785b93ef
DA
132int drm_fb_helper_blank(int blank, struct fb_info *info);
133int drm_fb_helper_pan_display(struct fb_var_screeninfo *var,
134 struct fb_info *info);
135int drm_fb_helper_set_par(struct fb_info *info);
136int drm_fb_helper_check_var(struct fb_var_screeninfo *var,
137 struct fb_info *info);
785b93ef 138
5ea1f752 139bool drm_fb_helper_restore_fbdev_mode_unlocked(struct drm_fb_helper *fb_helper);
b8017d6c
AT
140
141struct fb_info *drm_fb_helper_alloc_fbi(struct drm_fb_helper *fb_helper);
142void drm_fb_helper_unregister_fbi(struct drm_fb_helper *fb_helper);
143void drm_fb_helper_release_fbi(struct drm_fb_helper *fb_helper);
38651674 144void drm_fb_helper_fill_var(struct fb_info *info, struct drm_fb_helper *fb_helper,
785b93ef 145 uint32_t fb_width, uint32_t fb_height);
3632ef89
DA
146void drm_fb_helper_fill_fix(struct fb_info *info, uint32_t pitch,
147 uint32_t depth);
148
47074ab7
AT
149void drm_fb_helper_unlink_fbi(struct drm_fb_helper *fb_helper);
150
cbb1a82e
AT
151ssize_t drm_fb_helper_sys_read(struct fb_info *info, char __user *buf,
152 size_t count, loff_t *ppos);
153ssize_t drm_fb_helper_sys_write(struct fb_info *info, const char __user *buf,
154 size_t count, loff_t *ppos);
155
742547b7
AT
156void drm_fb_helper_sys_fillrect(struct fb_info *info,
157 const struct fb_fillrect *rect);
158void drm_fb_helper_sys_copyarea(struct fb_info *info,
159 const struct fb_copyarea *area);
160void drm_fb_helper_sys_imageblit(struct fb_info *info,
161 const struct fb_image *image);
162
163void drm_fb_helper_cfb_fillrect(struct fb_info *info,
164 const struct fb_fillrect *rect);
165void drm_fb_helper_cfb_copyarea(struct fb_info *info,
166 const struct fb_copyarea *area);
167void drm_fb_helper_cfb_imageblit(struct fb_info *info,
168 const struct fb_image *image);
169
fdefa58a
AT
170void drm_fb_helper_set_suspend(struct drm_fb_helper *fb_helper, int state);
171
068143d3 172int drm_fb_helper_setcmap(struct fb_cmap *cmap, struct fb_info *info);
d50ba256 173
7394371d 174int drm_fb_helper_hotplug_event(struct drm_fb_helper *fb_helper);
01934c2a 175int drm_fb_helper_initial_config(struct drm_fb_helper *fb_helper, int bpp_sel);
0b4c0f3f 176int drm_fb_helper_single_add_all_connectors(struct drm_fb_helper *fb_helper);
1a7aba7f
JB
177int drm_fb_helper_debug_enter(struct fb_info *info);
178int drm_fb_helper_debug_leave(struct fb_info *info);
2f1046f3
JB
179struct drm_display_mode *
180drm_has_preferred_mode(struct drm_fb_helper_connector *fb_connector,
181 int width, int height);
182struct drm_display_mode *
183drm_pick_cmdline_mode(struct drm_fb_helper_connector *fb_helper_conn,
184 int width, int height);
8be48d92 185
65c2a89c
DA
186int drm_fb_helper_add_one_connector(struct drm_fb_helper *fb_helper, struct drm_connector *connector);
187int drm_fb_helper_remove_one_connector(struct drm_fb_helper *fb_helper,
188 struct drm_connector *connector);
a03fdcb1
AT
189#else
190static inline void drm_fb_helper_prepare(struct drm_device *dev,
191 struct drm_fb_helper *helper,
192 const struct drm_fb_helper_funcs *funcs)
193{
194}
195
196static inline int drm_fb_helper_init(struct drm_device *dev,
197 struct drm_fb_helper *helper, int crtc_count,
198 int max_conn)
199{
200 return 0;
201}
202
203static inline void drm_fb_helper_fini(struct drm_fb_helper *helper)
204{
205}
206
207static inline int drm_fb_helper_blank(int blank, struct fb_info *info)
208{
209 return 0;
210}
211
212static inline int drm_fb_helper_pan_display(struct fb_var_screeninfo *var,
213 struct fb_info *info)
214{
215 return 0;
216}
217
218static inline int drm_fb_helper_set_par(struct fb_info *info)
219{
220 return 0;
221}
222
223static inline int drm_fb_helper_check_var(struct fb_var_screeninfo *var,
224 struct fb_info *info)
225{
226 return 0;
227}
228
229static inline bool
230drm_fb_helper_restore_fbdev_mode_unlocked(struct drm_fb_helper *fb_helper)
231{
232 return true;
233}
234
235static inline struct fb_info *
236drm_fb_helper_alloc_fbi(struct drm_fb_helper *fb_helper)
237{
238 return NULL;
239}
240
241static inline void drm_fb_helper_unregister_fbi(struct drm_fb_helper *fb_helper)
242{
243}
244static inline void drm_fb_helper_release_fbi(struct drm_fb_helper *fb_helper)
245{
246}
247
248static inline void drm_fb_helper_fill_var(struct fb_info *info,
249 struct drm_fb_helper *fb_helper,
250 uint32_t fb_width, uint32_t fb_height)
251{
252}
253
254static inline void drm_fb_helper_fill_fix(struct fb_info *info, uint32_t pitch,
255 uint32_t depth)
256{
257}
258
259static inline int drm_fb_helper_setcmap(struct fb_cmap *cmap,
260 struct fb_info *info)
261{
262 return 0;
263}
264
265static inline void drm_fb_helper_unlink_fbi(struct drm_fb_helper *fb_helper)
266{
267}
268
269static inline ssize_t drm_fb_helper_sys_read(struct fb_info *info,
270 char __user *buf, size_t count,
271 loff_t *ppos)
272{
273 return -ENODEV;
274}
275
276static inline ssize_t drm_fb_helper_sys_write(struct fb_info *info,
277 const char __user *buf,
278 size_t count, loff_t *ppos)
279{
280 return -ENODEV;
281}
282
283static inline void drm_fb_helper_sys_fillrect(struct fb_info *info,
284 const struct fb_fillrect *rect)
285{
286}
287
288static inline void drm_fb_helper_sys_copyarea(struct fb_info *info,
289 const struct fb_copyarea *area)
290{
291}
292
293static inline void drm_fb_helper_sys_imageblit(struct fb_info *info,
294 const struct fb_image *image)
295{
296}
297
298static inline void drm_fb_helper_cfb_fillrect(struct fb_info *info,
299 const struct fb_fillrect *rect)
300{
301}
302
303static inline void drm_fb_helper_cfb_copyarea(struct fb_info *info,
304 const struct fb_copyarea *area)
305{
306}
307
308static inline void drm_fb_helper_cfb_imageblit(struct fb_info *info,
309 const struct fb_image *image)
310{
311}
312
313static inline void drm_fb_helper_set_suspend(struct drm_fb_helper *fb_helper,
314 int state)
315{
316}
317
318static inline int drm_fb_helper_hotplug_event(struct drm_fb_helper *fb_helper)
319{
320 return 0;
321}
322
323static inline int drm_fb_helper_initial_config(struct drm_fb_helper *fb_helper,
324 int bpp_sel)
325{
326 return 0;
327}
328
329static inline int
330drm_fb_helper_single_add_all_connectors(struct drm_fb_helper *fb_helper)
331{
332 return 0;
333}
334
335static inline int drm_fb_helper_debug_enter(struct fb_info *info)
336{
337 return 0;
338}
339
340static inline int drm_fb_helper_debug_leave(struct fb_info *info)
341{
342 return 0;
343}
344
345static inline struct drm_display_mode *
346drm_has_preferred_mode(struct drm_fb_helper_connector *fb_connector,
347 int width, int height)
348{
349 return NULL;
350}
351
352static inline struct drm_display_mode *
353drm_pick_cmdline_mode(struct drm_fb_helper_connector *fb_helper_conn,
354 int width, int height)
355{
356 return NULL;
357}
358
359static inline int
360drm_fb_helper_add_one_connector(struct drm_fb_helper *fb_helper,
361 struct drm_connector *connector)
362{
363 return 0;
364}
365
366static inline int
367drm_fb_helper_remove_one_connector(struct drm_fb_helper *fb_helper,
368 struct drm_connector *connector)
369{
370 return 0;
371}
372#endif
785b93ef 373#endif