Rev 5056 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
5056 | serge | 1 | /* |
2 | * Copyright © 2006 Keith Packard |
||
3 | * Copyright © 2007-2008 Dave Airlie |
||
4 | * Copyright © 2007-2008 Intel Corporation |
||
5 | * Jesse Barnes |
||
6 | * Copyright © 2014 Intel Corporation |
||
7 | * Daniel Vetter |
||
8 | * |
||
9 | * Permission is hereby granted, free of charge, to any person obtaining a |
||
10 | * copy of this software and associated documentation files (the "Software"), |
||
11 | * to deal in the Software without restriction, including without limitation |
||
12 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||
13 | * and/or sell copies of the Software, and to permit persons to whom the |
||
14 | * Software is furnished to do so, subject to the following conditions: |
||
15 | * |
||
16 | * The above copyright notice and this permission notice shall be included in |
||
17 | * all copies or substantial portions of the Software. |
||
18 | * |
||
19 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||
20 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||
21 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||
22 | * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR |
||
23 | * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, |
||
24 | * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR |
||
25 | * OTHER DEALINGS IN THE SOFTWARE. |
||
26 | */ |
||
27 | #ifndef __DRM_MODES_H__ |
||
28 | #define __DRM_MODES_H__ |
||
29 | |||
30 | /* |
||
31 | * Note on terminology: here, for brevity and convenience, we refer to connector |
||
32 | * control chips as 'CRTCs'. They can control any type of connector, VGA, LVDS, |
||
33 | * DVI, etc. And 'screen' refers to the whole of the visible display, which |
||
34 | * may span multiple monitors (and therefore multiple CRTC and connector |
||
35 | * structures). |
||
36 | */ |
||
37 | |||
38 | enum drm_mode_status { |
||
39 | MODE_OK = 0, /* Mode OK */ |
||
40 | MODE_HSYNC, /* hsync out of range */ |
||
41 | MODE_VSYNC, /* vsync out of range */ |
||
42 | MODE_H_ILLEGAL, /* mode has illegal horizontal timings */ |
||
43 | MODE_V_ILLEGAL, /* mode has illegal horizontal timings */ |
||
44 | MODE_BAD_WIDTH, /* requires an unsupported linepitch */ |
||
45 | MODE_NOMODE, /* no mode with a matching name */ |
||
46 | MODE_NO_INTERLACE, /* interlaced mode not supported */ |
||
47 | MODE_NO_DBLESCAN, /* doublescan mode not supported */ |
||
48 | MODE_NO_VSCAN, /* multiscan mode not supported */ |
||
49 | MODE_MEM, /* insufficient video memory */ |
||
50 | MODE_VIRTUAL_X, /* mode width too large for specified virtual size */ |
||
51 | MODE_VIRTUAL_Y, /* mode height too large for specified virtual size */ |
||
52 | MODE_MEM_VIRT, /* insufficient video memory given virtual size */ |
||
53 | MODE_NOCLOCK, /* no fixed clock available */ |
||
54 | MODE_CLOCK_HIGH, /* clock required is too high */ |
||
55 | MODE_CLOCK_LOW, /* clock required is too low */ |
||
56 | MODE_CLOCK_RANGE, /* clock/mode isn't in a ClockRange */ |
||
57 | MODE_BAD_HVALUE, /* horizontal timing was out of range */ |
||
58 | MODE_BAD_VVALUE, /* vertical timing was out of range */ |
||
59 | MODE_BAD_VSCAN, /* VScan value out of range */ |
||
60 | MODE_HSYNC_NARROW, /* horizontal sync too narrow */ |
||
61 | MODE_HSYNC_WIDE, /* horizontal sync too wide */ |
||
62 | MODE_HBLANK_NARROW, /* horizontal blanking too narrow */ |
||
63 | MODE_HBLANK_WIDE, /* horizontal blanking too wide */ |
||
64 | MODE_VSYNC_NARROW, /* vertical sync too narrow */ |
||
65 | MODE_VSYNC_WIDE, /* vertical sync too wide */ |
||
66 | MODE_VBLANK_NARROW, /* vertical blanking too narrow */ |
||
67 | MODE_VBLANK_WIDE, /* vertical blanking too wide */ |
||
68 | MODE_PANEL, /* exceeds panel dimensions */ |
||
69 | MODE_INTERLACE_WIDTH, /* width too large for interlaced mode */ |
||
70 | MODE_ONE_WIDTH, /* only one width is supported */ |
||
71 | MODE_ONE_HEIGHT, /* only one height is supported */ |
||
72 | MODE_ONE_SIZE, /* only one resolution is supported */ |
||
73 | MODE_NO_REDUCED, /* monitor doesn't accept reduced blanking */ |
||
74 | MODE_NO_STEREO, /* stereo modes not supported */ |
||
75 | MODE_UNVERIFIED = -3, /* mode needs to reverified */ |
||
76 | MODE_BAD = -2, /* unspecified reason */ |
||
77 | MODE_ERROR = -1 /* error condition */ |
||
78 | }; |
||
79 | |||
80 | #define DRM_MODE_TYPE_CLOCK_CRTC_C (DRM_MODE_TYPE_CLOCK_C | \ |
||
81 | DRM_MODE_TYPE_CRTC_C) |
||
82 | |||
83 | #define DRM_MODE(nm, t, c, hd, hss, hse, ht, hsk, vd, vss, vse, vt, vs, f) \ |
||
84 | .name = nm, .status = 0, .type = (t), .clock = (c), \ |
||
85 | .hdisplay = (hd), .hsync_start = (hss), .hsync_end = (hse), \ |
||
86 | .htotal = (ht), .hskew = (hsk), .vdisplay = (vd), \ |
||
87 | .vsync_start = (vss), .vsync_end = (vse), .vtotal = (vt), \ |
||
88 | .vscan = (vs), .flags = (f), \ |
||
89 | .base.type = DRM_MODE_OBJECT_MODE |
||
90 | |||
91 | #define CRTC_INTERLACE_HALVE_V (1 << 0) /* halve V values for interlacing */ |
||
92 | #define CRTC_STEREO_DOUBLE (1 << 1) /* adjust timings for stereo modes */ |
||
6082 | serge | 93 | #define CRTC_NO_DBLSCAN (1 << 2) /* don't adjust doublescan */ |
94 | #define CRTC_NO_VSCAN (1 << 3) /* don't adjust doublescan */ |
||
95 | #define CRTC_STEREO_DOUBLE_ONLY (CRTC_STEREO_DOUBLE | CRTC_NO_DBLSCAN | CRTC_NO_VSCAN) |
||
5056 | serge | 96 | |
97 | #define DRM_MODE_FLAG_3D_MAX DRM_MODE_FLAG_3D_SIDE_BY_SIDE_HALF |
||
98 | |||
99 | struct drm_display_mode { |
||
100 | /* Header */ |
||
101 | struct list_head head; |
||
102 | struct drm_mode_object base; |
||
103 | |||
104 | char name[DRM_DISPLAY_MODE_LEN]; |
||
105 | |||
106 | enum drm_mode_status status; |
||
107 | unsigned int type; |
||
108 | |||
109 | /* Proposed mode values */ |
||
110 | int clock; /* in kHz */ |
||
111 | int hdisplay; |
||
112 | int hsync_start; |
||
113 | int hsync_end; |
||
114 | int htotal; |
||
115 | int hskew; |
||
116 | int vdisplay; |
||
117 | int vsync_start; |
||
118 | int vsync_end; |
||
119 | int vtotal; |
||
120 | int vscan; |
||
121 | unsigned int flags; |
||
122 | |||
123 | /* Addressable image size (may be 0 for projectors, etc.) */ |
||
124 | int width_mm; |
||
125 | int height_mm; |
||
126 | |||
127 | /* Actual mode we give to hw */ |
||
128 | int crtc_clock; /* in KHz */ |
||
129 | int crtc_hdisplay; |
||
130 | int crtc_hblank_start; |
||
131 | int crtc_hblank_end; |
||
132 | int crtc_hsync_start; |
||
133 | int crtc_hsync_end; |
||
134 | int crtc_htotal; |
||
135 | int crtc_hskew; |
||
136 | int crtc_vdisplay; |
||
137 | int crtc_vblank_start; |
||
138 | int crtc_vblank_end; |
||
139 | int crtc_vsync_start; |
||
140 | int crtc_vsync_end; |
||
141 | int crtc_vtotal; |
||
142 | |||
143 | /* Driver private mode info */ |
||
144 | int *private; |
||
145 | int private_flags; |
||
146 | |||
147 | int vrefresh; /* in Hz */ |
||
148 | int hsync; /* in kHz */ |
||
149 | enum hdmi_picture_aspect picture_aspect_ratio; |
||
150 | }; |
||
151 | |||
152 | /* mode specified on the command line */ |
||
153 | struct drm_cmdline_mode { |
||
154 | bool specified; |
||
155 | bool refresh_specified; |
||
156 | bool bpp_specified; |
||
157 | int xres, yres; |
||
158 | int bpp; |
||
159 | int refresh; |
||
160 | bool rb; |
||
161 | bool interlace; |
||
162 | bool cvt; |
||
163 | bool margins; |
||
164 | enum drm_connector_force force; |
||
165 | }; |
||
166 | |||
167 | /** |
||
168 | * drm_mode_is_stereo - check for stereo mode flags |
||
169 | * @mode: drm_display_mode to check |
||
170 | * |
||
171 | * Returns: |
||
172 | * True if the mode is one of the stereo modes (like side-by-side), false if |
||
173 | * not. |
||
174 | */ |
||
175 | static inline bool drm_mode_is_stereo(const struct drm_display_mode *mode) |
||
176 | { |
||
177 | return mode->flags & DRM_MODE_FLAG_3D_MASK; |
||
178 | } |
||
179 | |||
180 | struct drm_connector; |
||
181 | struct drm_cmdline_mode; |
||
182 | |||
183 | struct drm_display_mode *drm_mode_create(struct drm_device *dev); |
||
184 | void drm_mode_destroy(struct drm_device *dev, struct drm_display_mode *mode); |
||
6082 | serge | 185 | void drm_mode_convert_to_umode(struct drm_mode_modeinfo *out, |
186 | const struct drm_display_mode *in); |
||
187 | int drm_mode_convert_umode(struct drm_display_mode *out, |
||
188 | const struct drm_mode_modeinfo *in); |
||
5056 | serge | 189 | void drm_mode_probed_add(struct drm_connector *connector, struct drm_display_mode *mode); |
190 | void drm_mode_debug_printmodeline(const struct drm_display_mode *mode); |
||
191 | |||
192 | struct drm_display_mode *drm_cvt_mode(struct drm_device *dev, |
||
193 | int hdisplay, int vdisplay, int vrefresh, |
||
194 | bool reduced, bool interlaced, |
||
195 | bool margins); |
||
196 | struct drm_display_mode *drm_gtf_mode(struct drm_device *dev, |
||
197 | int hdisplay, int vdisplay, int vrefresh, |
||
198 | bool interlaced, int margins); |
||
199 | struct drm_display_mode *drm_gtf_mode_complex(struct drm_device *dev, |
||
200 | int hdisplay, int vdisplay, |
||
201 | int vrefresh, bool interlaced, |
||
202 | int margins, |
||
203 | int GTF_M, int GTF_2C, |
||
204 | int GTF_K, int GTF_2J); |
||
205 | void drm_display_mode_from_videomode(const struct videomode *vm, |
||
206 | struct drm_display_mode *dmode); |
||
6082 | serge | 207 | void drm_display_mode_to_videomode(const struct drm_display_mode *dmode, |
208 | struct videomode *vm); |
||
5056 | serge | 209 | int of_get_drm_display_mode(struct device_node *np, |
210 | struct drm_display_mode *dmode, |
||
211 | int index); |
||
212 | |||
213 | void drm_mode_set_name(struct drm_display_mode *mode); |
||
214 | int drm_mode_hsync(const struct drm_display_mode *mode); |
||
215 | int drm_mode_vrefresh(const struct drm_display_mode *mode); |
||
216 | |||
217 | void drm_mode_set_crtcinfo(struct drm_display_mode *p, |
||
218 | int adjust_flags); |
||
219 | void drm_mode_copy(struct drm_display_mode *dst, |
||
220 | const struct drm_display_mode *src); |
||
221 | struct drm_display_mode *drm_mode_duplicate(struct drm_device *dev, |
||
222 | const struct drm_display_mode *mode); |
||
223 | bool drm_mode_equal(const struct drm_display_mode *mode1, |
||
224 | const struct drm_display_mode *mode2); |
||
225 | bool drm_mode_equal_no_clocks_no_stereo(const struct drm_display_mode *mode1, |
||
226 | const struct drm_display_mode *mode2); |
||
227 | |||
228 | /* for use by the crtc helper probe functions */ |
||
6082 | serge | 229 | enum drm_mode_status drm_mode_validate_basic(const struct drm_display_mode *mode); |
230 | enum drm_mode_status drm_mode_validate_size(const struct drm_display_mode *mode, |
||
231 | int maxX, int maxY); |
||
5056 | serge | 232 | void drm_mode_prune_invalid(struct drm_device *dev, |
233 | struct list_head *mode_list, bool verbose); |
||
234 | void drm_mode_sort(struct list_head *mode_list); |
||
235 | void drm_mode_connector_list_update(struct drm_connector *connector, bool merge_type_bits); |
||
236 | |||
237 | /* parsing cmdline modes */ |
||
238 | bool |
||
239 | drm_mode_parse_command_line_for_connector(const char *mode_option, |
||
240 | struct drm_connector *connector, |
||
241 | struct drm_cmdline_mode *mode); |
||
242 | struct drm_display_mode * |
||
243 | drm_mode_create_from_cmdline_mode(struct drm_device *dev, |
||
244 | struct drm_cmdline_mode *cmd); |
||
245 | |||
246 | #endif /* __DRM_MODES_H__ */><>><>><>><> |