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 | |
33 | struct drm_fb_helper; |
34 | |
35 | #include <linux/kgdb.h> |
36 | |
37 | #ifdef __NetBSD__ |
38 | #include <sys/device_if.h> |
39 | #endif |
40 | |
41 | struct drm_fb_helper_crtc { |
42 | struct drm_mode_set mode_set; |
43 | struct drm_display_mode *desired_mode; |
44 | }; |
45 | |
46 | struct drm_fb_helper_surface_size { |
47 | u32 fb_width; |
48 | u32 fb_height; |
49 | u32 surface_width; |
50 | u32 surface_height; |
51 | u32 surface_bpp; |
52 | u32 surface_depth; |
53 | }; |
54 | |
55 | /** |
56 | * struct drm_fb_helper_funcs - driver callbacks for the fbdev emulation library |
57 | * @gamma_set: Set the given gamma lut register on the given crtc. |
58 | * @gamma_get: Read the given gamma lut register on the given crtc, used to |
59 | * save the current lut when force-restoring the fbdev for e.g. |
60 | * kdbg. |
61 | * @fb_probe: Driver callback to allocate and initialize the fbdev info |
62 | * structure. Furthermore it also needs to allocate the drm |
63 | * framebuffer used to back the fbdev. |
64 | * @initial_config: Setup an initial fbdev display configuration |
65 | * |
66 | * Driver callbacks used by the fbdev emulation helper library. |
67 | */ |
68 | struct drm_fb_helper_funcs { |
69 | void (*gamma_set)(struct drm_crtc *crtc, u16 red, u16 green, |
70 | u16 blue, int regno); |
71 | void (*gamma_get)(struct drm_crtc *crtc, u16 *red, u16 *green, |
72 | u16 *blue, int regno); |
73 | |
74 | int (*fb_probe)(struct drm_fb_helper *helper, |
75 | struct drm_fb_helper_surface_size *sizes); |
76 | bool (*initial_config)(struct drm_fb_helper *fb_helper, |
77 | struct drm_fb_helper_crtc **crtcs, |
78 | struct drm_display_mode **modes, |
79 | bool *enabled, int width, int height); |
80 | }; |
81 | |
82 | struct drm_fb_helper_connector { |
83 | struct drm_connector *connector; |
84 | struct drm_cmdline_mode cmdline_mode; |
85 | }; |
86 | |
87 | struct drm_fb_helper { |
88 | struct drm_framebuffer *fb; |
89 | struct drm_device *dev; |
90 | int crtc_count; |
91 | struct drm_fb_helper_crtc *crtc_info; |
92 | int connector_count; |
93 | struct drm_fb_helper_connector **connector_info; |
94 | struct drm_fb_helper_funcs *funcs; |
95 | #ifdef __NetBSD__ /* XXX fb info */ |
96 | device_t fbdev; |
97 | #else |
98 | struct fb_info *fbdev; |
99 | #endif |
100 | u32 pseudo_palette[17]; |
101 | struct list_head kernel_fb_list; |
102 | |
103 | /* we got a hotplug but fbdev wasn't running the console |
104 | delay until next set_par */ |
105 | bool delayed_hotplug; |
106 | }; |
107 | |
108 | int drm_fb_helper_init(struct drm_device *dev, |
109 | struct drm_fb_helper *helper, int crtc_count, |
110 | int max_conn); |
111 | void drm_fb_helper_fini(struct drm_fb_helper *helper); |
112 | #ifdef __NetBSD__ /* XXX fb info */ |
113 | int drm_fb_helper_set_config(struct drm_fb_helper *); |
114 | #else |
115 | int drm_fb_helper_blank(int blank, struct fb_info *info); |
116 | int drm_fb_helper_pan_display(struct fb_var_screeninfo *var, |
117 | struct fb_info *info); |
118 | int drm_fb_helper_set_par(struct fb_info *info); |
119 | int drm_fb_helper_check_var(struct fb_var_screeninfo *var, |
120 | struct fb_info *info); |
121 | #endif |
122 | |
123 | bool drm_fb_helper_restore_fbdev_mode(struct drm_fb_helper *fb_helper); |
124 | #ifndef __NetBSD__ /* XXX fb info */ |
125 | void drm_fb_helper_fill_var(struct fb_info *info, struct drm_fb_helper *fb_helper, |
126 | uint32_t fb_width, uint32_t fb_height); |
127 | void drm_fb_helper_fill_fix(struct fb_info *info, uint32_t pitch, |
128 | uint32_t depth); |
129 | #endif |
130 | |
131 | #ifndef __NetBSD__ /* XXX fb cmap */ |
132 | int drm_fb_helper_setcmap(struct fb_cmap *cmap, struct fb_info *info); |
133 | #endif |
134 | |
135 | int drm_fb_helper_hotplug_event(struct drm_fb_helper *fb_helper); |
136 | bool drm_fb_helper_initial_config(struct drm_fb_helper *fb_helper, int bpp_sel); |
137 | int drm_fb_helper_single_add_all_connectors(struct drm_fb_helper *fb_helper); |
138 | #ifndef __NetBSD__ /* XXX fb info */ |
139 | int drm_fb_helper_debug_enter(struct fb_info *info); |
140 | int drm_fb_helper_debug_leave(struct fb_info *info); |
141 | #endif |
142 | int drm_fb_helper_debug_enter_fb(struct drm_fb_helper *fb_helper); |
143 | int drm_fb_helper_debug_leave_fb(struct drm_fb_helper *fb_helper); |
144 | struct drm_display_mode * |
145 | drm_has_preferred_mode(struct drm_fb_helper_connector *fb_connector, |
146 | int width, int height); |
147 | struct drm_display_mode * |
148 | drm_pick_cmdline_mode(struct drm_fb_helper_connector *fb_helper_conn, |
149 | int width, int height); |
150 | |
151 | #endif |
152 | |