Commit | Line | Data |
---|---|---|
55310008 DV |
1 | /* |
2 | * Copyright © 2006 Keith Packard | |
3 | * Copyright © 2007-2008 Dave Airlie | |
4 | * Copyright © 2007-2008 Intel Corporation | |
5 | * Jesse Barnes <jesse.barnes@intel.com> | |
6 | * Copyright © 2014 Intel Corporation | |
7 | * Daniel Vetter <daniel.vetter@ffwll.ch> | |
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 */ | |
ecb7e16b GP |
93 | #define CRTC_NO_DBLSCAN (1 << 2) /* don't adjust doublescan */ |
94 | #define CRTC_NO_VSCAN (1 << 3) /* don't adjust doublescan */ | |
498b8738 | 95 | #define CRTC_STEREO_DOUBLE_ONLY (CRTC_STEREO_DOUBLE | CRTC_NO_DBLSCAN | CRTC_NO_VSCAN) |
55310008 DV |
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 */ | |
55310008 DV |
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 | ||
f5aabb97 DV |
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 | */ | |
55310008 DV |
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); | |
934a8a89 DS |
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); | |
55310008 DV |
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); | |
ba0c2422 DV |
205 | void drm_display_mode_from_videomode(const struct videomode *vm, |
206 | struct drm_display_mode *dmode); | |
d490f455 SL |
207 | void drm_display_mode_to_videomode(const struct drm_display_mode *dmode, |
208 | struct videomode *vm); | |
55310008 DV |
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); | |
55310008 DV |
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 */ | |
abc0b144 | 229 | enum drm_mode_status drm_mode_validate_basic(const struct drm_display_mode *mode); |
05acaec3 VS |
230 | enum drm_mode_status drm_mode_validate_size(const struct drm_display_mode *mode, |
231 | int maxX, int maxY); | |
55310008 DV |
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); | |
b87577b7 | 235 | void drm_mode_connector_list_update(struct drm_connector *connector, bool merge_type_bits); |
55310008 DV |
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__ */ |