kvm/x86: split ioapic-handled and EOI exit bitmaps
[deliverable/linux.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
9685cd9d
RC
107/**
108 * struct drm_fb_helper - helper to emulate fbdev on top of kms
109 * @fb: Scanout framebuffer object
110 * @dev: DRM device
111 * @crtc_count: number of possible CRTCs
112 * @crtc_info: per-CRTC helper state (mode, x/y offset, etc)
113 * @connector_count: number of connected connectors
114 * @connector_info_alloc_count: size of connector_info
115 * @funcs: driver callbacks for fb helper
116 * @fbdev: emulated fbdev device info struct
117 * @pseudo_palette: fake palette of 16 colors
118 * @kernel_fb_list: list_head in kernel_fb_helper_list
119 * @delayed_hotplug: was there a hotplug while kms master active?
120 */
785b93ef
DA
121struct drm_fb_helper {
122 struct drm_framebuffer *fb;
123 struct drm_device *dev;
785b93ef
DA
124 int crtc_count;
125 struct drm_fb_helper_crtc *crtc_info;
0b4c0f3f 126 int connector_count;
65c2a89c 127 int connector_info_alloc_count;
0b4c0f3f 128 struct drm_fb_helper_connector **connector_info;
3a493879 129 const struct drm_fb_helper_funcs *funcs;
38651674
DA
130 struct fb_info *fbdev;
131 u32 pseudo_palette[17];
785b93ef 132 struct list_head kernel_fb_list;
8be48d92 133
4abe3520
DA
134 /* we got a hotplug but fbdev wasn't running the console
135 delay until next set_par */
136 bool delayed_hotplug;
bbb1e524
RC
137
138 /**
139 * @atomic:
140 *
141 * Use atomic updates for restore_fbdev_mode(), etc. This defaults to
142 * true if driver has DRIVER_ATOMIC feature flag, but drivers can
143 * override it to true after drm_fb_helper_init() if they support atomic
144 * modeset but do not yet advertise DRIVER_ATOMIC (note that fb-helper
145 * does not require ASYNC commits).
146 */
147 bool atomic;
785b93ef
DA
148};
149
a03fdcb1 150#ifdef CONFIG_DRM_FBDEV_EMULATION
10a23102
TR
151void drm_fb_helper_prepare(struct drm_device *dev, struct drm_fb_helper *helper,
152 const struct drm_fb_helper_funcs *funcs);
4abe3520
DA
153int drm_fb_helper_init(struct drm_device *dev,
154 struct drm_fb_helper *helper, int crtc_count,
eb1f8e4f 155 int max_conn);
4abe3520 156void drm_fb_helper_fini(struct drm_fb_helper *helper);
785b93ef
DA
157int drm_fb_helper_blank(int blank, struct fb_info *info);
158int drm_fb_helper_pan_display(struct fb_var_screeninfo *var,
159 struct fb_info *info);
160int drm_fb_helper_set_par(struct fb_info *info);
161int drm_fb_helper_check_var(struct fb_var_screeninfo *var,
162 struct fb_info *info);
785b93ef 163
b7bdf0a8 164int drm_fb_helper_restore_fbdev_mode_unlocked(struct drm_fb_helper *fb_helper);
b8017d6c
AT
165
166struct fb_info *drm_fb_helper_alloc_fbi(struct drm_fb_helper *fb_helper);
167void drm_fb_helper_unregister_fbi(struct drm_fb_helper *fb_helper);
168void drm_fb_helper_release_fbi(struct drm_fb_helper *fb_helper);
38651674 169void drm_fb_helper_fill_var(struct fb_info *info, struct drm_fb_helper *fb_helper,
785b93ef 170 uint32_t fb_width, uint32_t fb_height);
3632ef89
DA
171void drm_fb_helper_fill_fix(struct fb_info *info, uint32_t pitch,
172 uint32_t depth);
173
47074ab7
AT
174void drm_fb_helper_unlink_fbi(struct drm_fb_helper *fb_helper);
175
cbb1a82e
AT
176ssize_t drm_fb_helper_sys_read(struct fb_info *info, char __user *buf,
177 size_t count, loff_t *ppos);
178ssize_t drm_fb_helper_sys_write(struct fb_info *info, const char __user *buf,
179 size_t count, loff_t *ppos);
180
742547b7
AT
181void drm_fb_helper_sys_fillrect(struct fb_info *info,
182 const struct fb_fillrect *rect);
183void drm_fb_helper_sys_copyarea(struct fb_info *info,
184 const struct fb_copyarea *area);
185void drm_fb_helper_sys_imageblit(struct fb_info *info,
186 const struct fb_image *image);
187
188void drm_fb_helper_cfb_fillrect(struct fb_info *info,
189 const struct fb_fillrect *rect);
190void drm_fb_helper_cfb_copyarea(struct fb_info *info,
191 const struct fb_copyarea *area);
192void drm_fb_helper_cfb_imageblit(struct fb_info *info,
193 const struct fb_image *image);
194
fdefa58a
AT
195void drm_fb_helper_set_suspend(struct drm_fb_helper *fb_helper, int state);
196
068143d3 197int drm_fb_helper_setcmap(struct fb_cmap *cmap, struct fb_info *info);
d50ba256 198
7394371d 199int drm_fb_helper_hotplug_event(struct drm_fb_helper *fb_helper);
01934c2a 200int drm_fb_helper_initial_config(struct drm_fb_helper *fb_helper, int bpp_sel);
0b4c0f3f 201int drm_fb_helper_single_add_all_connectors(struct drm_fb_helper *fb_helper);
1a7aba7f
JB
202int drm_fb_helper_debug_enter(struct fb_info *info);
203int drm_fb_helper_debug_leave(struct fb_info *info);
2f1046f3
JB
204struct drm_display_mode *
205drm_has_preferred_mode(struct drm_fb_helper_connector *fb_connector,
206 int width, int height);
207struct drm_display_mode *
208drm_pick_cmdline_mode(struct drm_fb_helper_connector *fb_helper_conn,
209 int width, int height);
8be48d92 210
65c2a89c
DA
211int drm_fb_helper_add_one_connector(struct drm_fb_helper *fb_helper, struct drm_connector *connector);
212int drm_fb_helper_remove_one_connector(struct drm_fb_helper *fb_helper,
213 struct drm_connector *connector);
a03fdcb1
AT
214#else
215static inline void drm_fb_helper_prepare(struct drm_device *dev,
216 struct drm_fb_helper *helper,
217 const struct drm_fb_helper_funcs *funcs)
218{
219}
220
221static inline int drm_fb_helper_init(struct drm_device *dev,
222 struct drm_fb_helper *helper, int crtc_count,
223 int max_conn)
224{
225 return 0;
226}
227
228static inline void drm_fb_helper_fini(struct drm_fb_helper *helper)
229{
230}
231
232static inline int drm_fb_helper_blank(int blank, struct fb_info *info)
233{
234 return 0;
235}
236
237static inline int drm_fb_helper_pan_display(struct fb_var_screeninfo *var,
238 struct fb_info *info)
239{
240 return 0;
241}
242
243static inline int drm_fb_helper_set_par(struct fb_info *info)
244{
245 return 0;
246}
247
248static inline int drm_fb_helper_check_var(struct fb_var_screeninfo *var,
249 struct fb_info *info)
250{
251 return 0;
252}
253
b7bdf0a8 254static inline int
a03fdcb1
AT
255drm_fb_helper_restore_fbdev_mode_unlocked(struct drm_fb_helper *fb_helper)
256{
b7bdf0a8 257 return 0;
a03fdcb1
AT
258}
259
260static inline struct fb_info *
261drm_fb_helper_alloc_fbi(struct drm_fb_helper *fb_helper)
262{
263 return NULL;
264}
265
266static inline void drm_fb_helper_unregister_fbi(struct drm_fb_helper *fb_helper)
267{
268}
269static inline void drm_fb_helper_release_fbi(struct drm_fb_helper *fb_helper)
270{
271}
272
273static inline void drm_fb_helper_fill_var(struct fb_info *info,
274 struct drm_fb_helper *fb_helper,
275 uint32_t fb_width, uint32_t fb_height)
276{
277}
278
279static inline void drm_fb_helper_fill_fix(struct fb_info *info, uint32_t pitch,
280 uint32_t depth)
281{
282}
283
284static inline int drm_fb_helper_setcmap(struct fb_cmap *cmap,
285 struct fb_info *info)
286{
287 return 0;
288}
289
290static inline void drm_fb_helper_unlink_fbi(struct drm_fb_helper *fb_helper)
291{
292}
293
294static inline ssize_t drm_fb_helper_sys_read(struct fb_info *info,
295 char __user *buf, size_t count,
296 loff_t *ppos)
297{
298 return -ENODEV;
299}
300
301static inline ssize_t drm_fb_helper_sys_write(struct fb_info *info,
302 const char __user *buf,
303 size_t count, loff_t *ppos)
304{
305 return -ENODEV;
306}
307
308static inline void drm_fb_helper_sys_fillrect(struct fb_info *info,
309 const struct fb_fillrect *rect)
310{
311}
312
313static inline void drm_fb_helper_sys_copyarea(struct fb_info *info,
314 const struct fb_copyarea *area)
315{
316}
317
318static inline void drm_fb_helper_sys_imageblit(struct fb_info *info,
319 const struct fb_image *image)
320{
321}
322
323static inline void drm_fb_helper_cfb_fillrect(struct fb_info *info,
324 const struct fb_fillrect *rect)
325{
326}
327
328static inline void drm_fb_helper_cfb_copyarea(struct fb_info *info,
329 const struct fb_copyarea *area)
330{
331}
332
333static inline void drm_fb_helper_cfb_imageblit(struct fb_info *info,
334 const struct fb_image *image)
335{
336}
337
338static inline void drm_fb_helper_set_suspend(struct drm_fb_helper *fb_helper,
339 int state)
340{
341}
342
343static inline int drm_fb_helper_hotplug_event(struct drm_fb_helper *fb_helper)
344{
345 return 0;
346}
347
348static inline int drm_fb_helper_initial_config(struct drm_fb_helper *fb_helper,
349 int bpp_sel)
350{
351 return 0;
352}
353
354static inline int
355drm_fb_helper_single_add_all_connectors(struct drm_fb_helper *fb_helper)
356{
357 return 0;
358}
359
360static inline int drm_fb_helper_debug_enter(struct fb_info *info)
361{
362 return 0;
363}
364
365static inline int drm_fb_helper_debug_leave(struct fb_info *info)
366{
367 return 0;
368}
369
370static inline struct drm_display_mode *
371drm_has_preferred_mode(struct drm_fb_helper_connector *fb_connector,
372 int width, int height)
373{
374 return NULL;
375}
376
377static inline struct drm_display_mode *
378drm_pick_cmdline_mode(struct drm_fb_helper_connector *fb_helper_conn,
379 int width, int height)
380{
381 return NULL;
382}
383
384static inline int
385drm_fb_helper_add_one_connector(struct drm_fb_helper *fb_helper,
386 struct drm_connector *connector)
387{
388 return 0;
389}
390
391static inline int
392drm_fb_helper_remove_one_connector(struct drm_fb_helper *fb_helper,
393 struct drm_connector *connector)
394{
395 return 0;
396}
397#endif
785b93ef 398#endif
This page took 0.312647 seconds and 5 git commands to generate.