Commit | Line | Data |
---|---|---|
f453ba04 DA |
1 | /* |
2 | * Copyright (c) 2006-2008 Intel Corporation | |
3 | * Copyright (c) 2007 Dave Airlie <airlied@linux.ie> | |
4 | * | |
5 | * DRM core CRTC related functions | |
6 | * | |
7 | * Permission to use, copy, modify, distribute, and sell this software and its | |
8 | * documentation for any purpose is hereby granted without fee, provided that | |
9 | * the above copyright notice appear in all copies and that both that copyright | |
10 | * notice and this permission notice appear in supporting documentation, and | |
11 | * that the name of the copyright holders not be used in advertising or | |
12 | * publicity pertaining to distribution of the software without specific, | |
13 | * written prior permission. The copyright holders make no representations | |
14 | * about the suitability of this software for any purpose. It is provided "as | |
15 | * is" without express or implied warranty. | |
16 | * | |
17 | * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, | |
18 | * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO | |
19 | * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR | |
20 | * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, | |
21 | * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER | |
22 | * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE | |
23 | * OF THIS SOFTWARE. | |
24 | * | |
25 | * Authors: | |
26 | * Keith Packard | |
27 | * Eric Anholt <eric@anholt.net> | |
28 | * Dave Airlie <airlied@linux.ie> | |
29 | * Jesse Barnes <jesse.barnes@intel.com> | |
30 | */ | |
31 | ||
2d1a8a48 | 32 | #include <linux/export.h> |
0500c04e | 33 | #include <linux/kernel.h> |
0603ba14 | 34 | #include <linux/moduleparam.h> |
f158936b | 35 | #include <linux/dynamic_debug.h> |
2d1a8a48 | 36 | |
321ebf04 | 37 | #include <drm/drm_atomic.h> |
0500c04e | 38 | #include <drm/drm_atomic_helper.h> |
72fdb40c | 39 | #include <drm/drm_atomic_uapi.h> |
ee68c743 | 40 | #include <drm/drm_bridge.h> |
760285e7 | 41 | #include <drm/drm_crtc.h> |
760285e7 | 42 | #include <drm/drm_crtc_helper.h> |
0500c04e SR |
43 | #include <drm/drm_drv.h> |
44 | #include <drm/drm_edid.h> | |
45 | #include <drm/drm_encoder.h> | |
0500c04e | 46 | #include <drm/drm_fourcc.h> |
720cf96d | 47 | #include <drm/drm_framebuffer.h> |
0500c04e SR |
48 | #include <drm/drm_print.h> |
49 | #include <drm/drm_vblank.h> | |
f453ba04 | 50 | |
8dc056ef BG |
51 | #include "drm_crtc_helper_internal.h" |
52 | ||
f158936b JC |
53 | DECLARE_DYNDBG_CLASSMAP(drm_debug_classes, DD_CLASS_TYPE_DISJOINT_BITS, 0, |
54 | "DRM_UT_CORE", | |
55 | "DRM_UT_DRIVER", | |
56 | "DRM_UT_KMS", | |
57 | "DRM_UT_PRIME", | |
58 | "DRM_UT_ATOMIC", | |
59 | "DRM_UT_VBL", | |
60 | "DRM_UT_STATE", | |
61 | "DRM_UT_LEASE", | |
62 | "DRM_UT_DP", | |
63 | "DRM_UT_DRMRES"); | |
64 | ||
3150c7d0 DV |
65 | /** |
66 | * DOC: overview | |
67 | * | |
68 | * The CRTC modeset helper library provides a default set_config implementation | |
69 | * in drm_crtc_helper_set_config(). Plus a few other convenience functions using | |
70 | * the same callbacks which drivers can use to e.g. restore the modeset | |
71 | * configuration on resume with drm_helper_resume_force_mode(). | |
72 | * | |
2be94971 | 73 | * Note that this helper library doesn't track the current power state of CRTCs |
6806cdf9 DV |
74 | * and encoders. It can call callbacks like &drm_encoder_helper_funcs.dpms even |
75 | * though the hardware is already in the desired state. This deficiency has been | |
76 | * fixed in the atomic helpers. | |
2be94971 | 77 | * |
3150c7d0 DV |
78 | * The driver callbacks are mostly compatible with the atomic modeset helpers, |
79 | * except for the handling of the primary plane: Atomic helpers require that the | |
80 | * primary plane is implemented as a real standalone plane and not directly tied | |
81 | * to the CRTC state. For easier transition this library provides functions to | |
82 | * implement the old semantics required by the CRTC helpers using the new plane | |
83 | * and atomic helper callbacks. | |
84 | * | |
85 | * Drivers are strongly urged to convert to the atomic helpers (by way of first | |
86 | * converting to the plane helpers). New drivers must not use these functions | |
87 | * but need to implement the atomic interface instead, potentially using the | |
88 | * atomic helpers for that. | |
092d01da DV |
89 | * |
90 | * These legacy modeset helpers use the same function table structures as | |
91 | * all other modesetting helpers. See the documentation for struct | |
ea0dd85a | 92 | * &drm_crtc_helper_funcs, &struct drm_encoder_helper_funcs and struct |
092d01da | 93 | * &drm_connector_helper_funcs. |
3150c7d0 | 94 | */ |
92b6f89f | 95 | |
c9fb15f6 KP |
96 | /** |
97 | * drm_helper_encoder_in_use - check if a given encoder is in use | |
98 | * @encoder: encoder to check | |
99 | * | |
3fcc42e0 DV |
100 | * Checks whether @encoder is with the current mode setting output configuration |
101 | * in use by any connector. This doesn't mean that it is actually enabled since | |
102 | * the DPMS state is tracked separately. | |
c9fb15f6 | 103 | * |
3fcc42e0 DV |
104 | * Returns: |
105 | * True if @encoder is used, false otherwise. | |
c9fb15f6 KP |
106 | */ |
107 | bool drm_helper_encoder_in_use(struct drm_encoder *encoder) | |
108 | { | |
109 | struct drm_connector *connector; | |
c36a3254 | 110 | struct drm_connector_list_iter conn_iter; |
c9fb15f6 | 111 | struct drm_device *dev = encoder->dev; |
62ff94a5 | 112 | |
fad8e251 | 113 | drm_WARN_ON(dev, drm_drv_uses_atomic_modeset(dev)); |
2b5ab0ee | 114 | |
ba6f5826 SA |
115 | /* |
116 | * We can expect this mutex to be locked if we are not panicking. | |
117 | * Locking is currently fubar in the panic handler. | |
118 | */ | |
8d4ad9d4 | 119 | if (!oops_in_progress) { |
fad8e251 JN |
120 | drm_WARN_ON(dev, !mutex_is_locked(&dev->mode_config.mutex)); |
121 | drm_WARN_ON(dev, !drm_modeset_is_locked(&dev->mode_config.connection_mutex)); | |
8d4ad9d4 | 122 | } |
ba6f5826 | 123 | |
c36a3254 | 124 | |
b982dab1 | 125 | drm_connector_list_iter_begin(dev, &conn_iter); |
c36a3254 DV |
126 | drm_for_each_connector_iter(connector, &conn_iter) { |
127 | if (connector->encoder == encoder) { | |
b982dab1 | 128 | drm_connector_list_iter_end(&conn_iter); |
c9fb15f6 | 129 | return true; |
c36a3254 DV |
130 | } |
131 | } | |
b982dab1 | 132 | drm_connector_list_iter_end(&conn_iter); |
c9fb15f6 KP |
133 | return false; |
134 | } | |
135 | EXPORT_SYMBOL(drm_helper_encoder_in_use); | |
136 | ||
f453ba04 DA |
137 | /** |
138 | * drm_helper_crtc_in_use - check if a given CRTC is in a mode_config | |
139 | * @crtc: CRTC to check | |
140 | * | |
3fcc42e0 DV |
141 | * Checks whether @crtc is with the current mode setting output configuration |
142 | * in use by any connector. This doesn't mean that it is actually enabled since | |
143 | * the DPMS state is tracked separately. | |
f453ba04 | 144 | * |
3fcc42e0 DV |
145 | * Returns: |
146 | * True if @crtc is used, false otherwise. | |
f453ba04 DA |
147 | */ |
148 | bool drm_helper_crtc_in_use(struct drm_crtc *crtc) | |
149 | { | |
150 | struct drm_encoder *encoder; | |
151 | struct drm_device *dev = crtc->dev; | |
62ff94a5 | 152 | |
fad8e251 | 153 | drm_WARN_ON(dev, drm_drv_uses_atomic_modeset(dev)); |
2b5ab0ee | 154 | |
ba6f5826 SA |
155 | /* |
156 | * We can expect this mutex to be locked if we are not panicking. | |
157 | * Locking is currently fubar in the panic handler. | |
158 | */ | |
159 | if (!oops_in_progress) | |
fad8e251 | 160 | drm_WARN_ON(dev, !mutex_is_locked(&dev->mode_config.mutex)); |
ba6f5826 | 161 | |
e4f62546 | 162 | drm_for_each_encoder(encoder, dev) |
c9fb15f6 | 163 | if (encoder->crtc == crtc && drm_helper_encoder_in_use(encoder)) |
f453ba04 DA |
164 | return true; |
165 | return false; | |
166 | } | |
167 | EXPORT_SYMBOL(drm_helper_crtc_in_use); | |
168 | ||
86a1b9d1 BS |
169 | static void |
170 | drm_encoder_disable(struct drm_encoder *encoder) | |
171 | { | |
be26a66d | 172 | const struct drm_encoder_helper_funcs *encoder_funcs = encoder->helper_private; |
86a1b9d1 | 173 | |
75229eca NT |
174 | if (!encoder_funcs) |
175 | return; | |
176 | ||
86a1b9d1 BS |
177 | if (encoder_funcs->disable) |
178 | (*encoder_funcs->disable)(encoder); | |
75229eca | 179 | else if (encoder_funcs->dpms) |
86a1b9d1 BS |
180 | (*encoder_funcs->dpms)(encoder, DRM_MODE_DPMS_OFF); |
181 | } | |
182 | ||
b182cc59 | 183 | static void __drm_helper_disable_unused_functions(struct drm_device *dev) |
f453ba04 DA |
184 | { |
185 | struct drm_encoder *encoder; | |
f453ba04 DA |
186 | struct drm_crtc *crtc; |
187 | ||
62ff94a5 DV |
188 | drm_warn_on_modeset_not_all_locked(dev); |
189 | ||
6295d607 | 190 | drm_for_each_encoder(encoder, dev) { |
92971021 | 191 | if (!drm_helper_encoder_in_use(encoder)) { |
86a1b9d1 | 192 | drm_encoder_disable(encoder); |
b5e6c1da | 193 | /* disconnect encoder from any connector */ |
9c552dd7 | 194 | encoder->crtc = NULL; |
a3a0544b | 195 | } |
f453ba04 DA |
196 | } |
197 | ||
6295d607 | 198 | drm_for_each_crtc(crtc, dev) { |
be26a66d | 199 | const struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private; |
948de842 | 200 | |
f453ba04 DA |
201 | crtc->enabled = drm_helper_crtc_in_use(crtc); |
202 | if (!crtc->enabled) { | |
5c8d7171 AD |
203 | if (crtc_funcs->disable) |
204 | (*crtc_funcs->disable)(crtc); | |
205 | else | |
206 | (*crtc_funcs->dpms)(crtc, DRM_MODE_DPMS_OFF); | |
f4510a27 | 207 | crtc->primary->fb = NULL; |
f453ba04 DA |
208 | } |
209 | } | |
210 | } | |
b182cc59 DV |
211 | |
212 | /** | |
213 | * drm_helper_disable_unused_functions - disable unused objects | |
214 | * @dev: DRM device | |
215 | * | |
216 | * This function walks through the entire mode setting configuration of @dev. It | |
2be94971 DV |
217 | * will remove any CRTC links of unused encoders and encoder links of |
218 | * disconnected connectors. Then it will disable all unused encoders and CRTCs | |
b182cc59 DV |
219 | * either by calling their disable callback if available or by calling their |
220 | * dpms callback with DRM_MODE_DPMS_OFF. | |
09859d2a DV |
221 | * |
222 | * NOTE: | |
223 | * | |
224 | * This function is part of the legacy modeset helper library and will cause | |
225 | * major confusion with atomic drivers. This is because atomic helpers guarantee | |
226 | * to never call ->disable() hooks on a disabled function, or ->enable() hooks | |
227 | * on an enabled functions. drm_helper_disable_unused_functions() on the other | |
228 | * hand throws such guarantees into the wind and calls disable hooks | |
229 | * unconditionally on unused functions. | |
b182cc59 DV |
230 | */ |
231 | void drm_helper_disable_unused_functions(struct drm_device *dev) | |
232 | { | |
fad8e251 | 233 | drm_WARN_ON(dev, drm_drv_uses_atomic_modeset(dev)); |
6605ca0f | 234 | |
76fd2c37 | 235 | drm_modeset_lock_all(dev); |
b182cc59 | 236 | __drm_helper_disable_unused_functions(dev); |
76fd2c37 | 237 | drm_modeset_unlock_all(dev); |
b182cc59 | 238 | } |
f453ba04 DA |
239 | EXPORT_SYMBOL(drm_helper_disable_unused_functions); |
240 | ||
7bec756c JB |
241 | /* |
242 | * Check the CRTC we're going to map each output to vs. its current | |
243 | * CRTC. If they don't match, we have to disable the output and the CRTC | |
244 | * since the driver will have to re-route things. | |
245 | */ | |
246 | static void | |
247 | drm_crtc_prepare_encoders(struct drm_device *dev) | |
248 | { | |
be26a66d | 249 | const struct drm_encoder_helper_funcs *encoder_funcs; |
7bec756c JB |
250 | struct drm_encoder *encoder; |
251 | ||
6295d607 | 252 | drm_for_each_encoder(encoder, dev) { |
7bec756c | 253 | encoder_funcs = encoder->helper_private; |
75229eca NT |
254 | if (!encoder_funcs) |
255 | continue; | |
256 | ||
7bec756c JB |
257 | /* Disable unused encoders */ |
258 | if (encoder->crtc == NULL) | |
86a1b9d1 | 259 | drm_encoder_disable(encoder); |
7bec756c JB |
260 | } |
261 | } | |
262 | ||
f453ba04 | 263 | /** |
0d4ed4c8 | 264 | * drm_crtc_helper_set_mode - internal helper to set a mode |
f453ba04 DA |
265 | * @crtc: CRTC to program |
266 | * @mode: mode to use | |
4c9287c6 AD |
267 | * @x: horizontal offset into the surface |
268 | * @y: vertical offset into the surface | |
0d4ed4c8 | 269 | * @old_fb: old framebuffer, for cleanup |
f453ba04 | 270 | * |
f453ba04 | 271 | * Try to set @mode on @crtc. Give @crtc and its associated connectors a chance |
0d4ed4c8 DV |
272 | * to fixup or reject the mode prior to trying to set it. This is an internal |
273 | * helper that drivers could e.g. use to update properties that require the | |
274 | * entire output pipe to be disabled and re-enabled in a new configuration. For | |
275 | * example for changing whether audio is enabled on a hdmi link or for changing | |
276 | * panel fitter or dither attributes. It is also called by the | |
277 | * drm_crtc_helper_set_config() helper function to drive the mode setting | |
278 | * sequence. | |
f453ba04 | 279 | * |
3fcc42e0 DV |
280 | * Returns: |
281 | * True if the mode was set successfully, false otherwise. | |
f453ba04 DA |
282 | */ |
283 | bool drm_crtc_helper_set_mode(struct drm_crtc *crtc, | |
284 | struct drm_display_mode *mode, | |
3c4fdcfb KH |
285 | int x, int y, |
286 | struct drm_framebuffer *old_fb) | |
f453ba04 DA |
287 | { |
288 | struct drm_device *dev = crtc->dev; | |
5a27528a | 289 | struct drm_display_mode *adjusted_mode, saved_mode, saved_hwmode; |
be26a66d JN |
290 | const struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private; |
291 | const struct drm_encoder_helper_funcs *encoder_funcs; | |
f453ba04 | 292 | int saved_x, saved_y; |
7e99acdc | 293 | bool saved_enabled; |
f453ba04 DA |
294 | struct drm_encoder *encoder; |
295 | bool ret = true; | |
296 | ||
fad8e251 | 297 | drm_WARN_ON(dev, drm_drv_uses_atomic_modeset(dev)); |
2b5ab0ee | 298 | |
62ff94a5 DV |
299 | drm_warn_on_modeset_not_all_locked(dev); |
300 | ||
7e99acdc | 301 | saved_enabled = crtc->enabled; |
f453ba04 | 302 | crtc->enabled = drm_helper_crtc_in_use(crtc); |
f453ba04 DA |
303 | if (!crtc->enabled) |
304 | return true; | |
305 | ||
021a8455 | 306 | adjusted_mode = drm_mode_duplicate(dev, mode); |
7e99acdc IH |
307 | if (!adjusted_mode) { |
308 | crtc->enabled = saved_enabled; | |
6bfc56aa | 309 | return false; |
7e99acdc | 310 | } |
021a8455 | 311 | |
563c4a75 VS |
312 | drm_mode_init(&saved_mode, &crtc->mode); |
313 | drm_mode_init(&saved_hwmode, &crtc->hwmode); | |
f453ba04 DA |
314 | saved_x = crtc->x; |
315 | saved_y = crtc->y; | |
316 | ||
317 | /* Update crtc values up front so the driver can rely on them for mode | |
318 | * setting. | |
319 | */ | |
a3342f4d | 320 | drm_mode_copy(&crtc->mode, mode); |
f453ba04 DA |
321 | crtc->x = x; |
322 | crtc->y = y; | |
323 | ||
f453ba04 DA |
324 | /* Pass our mode to the connectors and the CRTC to give them a chance to |
325 | * adjust it according to limitations or connector properties, and also | |
326 | * a chance to reject the mode entirely. | |
327 | */ | |
6295d607 | 328 | drm_for_each_encoder(encoder, dev) { |
f453ba04 DA |
329 | |
330 | if (encoder->crtc != crtc) | |
331 | continue; | |
3b336ec4 | 332 | |
75229eca NT |
333 | encoder_funcs = encoder->helper_private; |
334 | if (!encoder_funcs) | |
335 | continue; | |
336 | ||
f453ba04 | 337 | encoder_funcs = encoder->helper_private; |
3c5b2673 CP |
338 | if (encoder_funcs->mode_fixup) { |
339 | if (!(ret = encoder_funcs->mode_fixup(encoder, mode, | |
340 | adjusted_mode))) { | |
fad8e251 JN |
341 | drm_dbg_kms(dev, "[ENCODER:%d:%s] mode fixup failed\n", |
342 | encoder->base.id, encoder->name); | |
3c5b2673 CP |
343 | goto done; |
344 | } | |
f453ba04 DA |
345 | } |
346 | } | |
347 | ||
49f718c5 CP |
348 | if (crtc_funcs->mode_fixup) { |
349 | if (!(ret = crtc_funcs->mode_fixup(crtc, mode, | |
350 | adjusted_mode))) { | |
fad8e251 JN |
351 | drm_dbg_kms(dev, "[CRTC:%d:%s] mode fixup failed\n", |
352 | crtc->base.id, crtc->name); | |
49f718c5 CP |
353 | goto done; |
354 | } | |
f453ba04 | 355 | } |
fad8e251 | 356 | drm_dbg_kms(dev, "[CRTC:%d:%s]\n", crtc->base.id, crtc->name); |
f453ba04 | 357 | |
a3342f4d | 358 | drm_mode_copy(&crtc->hwmode, adjusted_mode); |
5a27528a | 359 | |
f453ba04 | 360 | /* Prepare the encoders and CRTCs before setting the mode. */ |
6295d607 | 361 | drm_for_each_encoder(encoder, dev) { |
f453ba04 DA |
362 | |
363 | if (encoder->crtc != crtc) | |
364 | continue; | |
3b336ec4 | 365 | |
75229eca NT |
366 | encoder_funcs = encoder->helper_private; |
367 | if (!encoder_funcs) | |
368 | continue; | |
369 | ||
f453ba04 | 370 | /* Disable the encoders as the first thing we do. */ |
75229eca NT |
371 | if (encoder_funcs->prepare) |
372 | encoder_funcs->prepare(encoder); | |
f453ba04 DA |
373 | } |
374 | ||
7bec756c JB |
375 | drm_crtc_prepare_encoders(dev); |
376 | ||
f453ba04 DA |
377 | crtc_funcs->prepare(crtc); |
378 | ||
379 | /* Set up the DPLL and any encoders state that needs to adjust or depend | |
380 | * on the DPLL. | |
381 | */ | |
5c3b82e2 CW |
382 | ret = !crtc_funcs->mode_set(crtc, mode, adjusted_mode, x, y, old_fb); |
383 | if (!ret) | |
384 | goto done; | |
f453ba04 | 385 | |
6295d607 | 386 | drm_for_each_encoder(encoder, dev) { |
f453ba04 DA |
387 | |
388 | if (encoder->crtc != crtc) | |
389 | continue; | |
390 | ||
75229eca NT |
391 | encoder_funcs = encoder->helper_private; |
392 | if (!encoder_funcs) | |
393 | continue; | |
394 | ||
fad8e251 JN |
395 | drm_dbg_kms(dev, "[ENCODER:%d:%s] set [MODE:%s]\n", |
396 | encoder->base.id, encoder->name, mode->name); | |
75229eca NT |
397 | if (encoder_funcs->mode_set) |
398 | encoder_funcs->mode_set(encoder, mode, adjusted_mode); | |
f453ba04 DA |
399 | } |
400 | ||
401 | /* Now enable the clocks, plane, pipe, and connectors that we set up. */ | |
402 | crtc_funcs->commit(crtc); | |
403 | ||
6295d607 | 404 | drm_for_each_encoder(encoder, dev) { |
f453ba04 DA |
405 | |
406 | if (encoder->crtc != crtc) | |
407 | continue; | |
408 | ||
75229eca NT |
409 | encoder_funcs = encoder->helper_private; |
410 | if (!encoder_funcs) | |
411 | continue; | |
412 | ||
75229eca NT |
413 | if (encoder_funcs->commit) |
414 | encoder_funcs->commit(encoder); | |
f453ba04 DA |
415 | } |
416 | ||
27641c3f MK |
417 | /* Calculate and store various constants which |
418 | * are later needed by vblank and swap-completion | |
419 | * timestamping. They are derived from true hwmode. | |
420 | */ | |
545cdd55 | 421 | drm_calc_timestamping_constants(crtc, &crtc->hwmode); |
27641c3f | 422 | |
f453ba04 DA |
423 | /* FIXME: add subpixel order */ |
424 | done: | |
021a8455 | 425 | drm_mode_destroy(dev, adjusted_mode); |
f453ba04 | 426 | if (!ret) { |
7e99acdc | 427 | crtc->enabled = saved_enabled; |
563c4a75 VS |
428 | drm_mode_copy(&crtc->mode, &saved_mode); |
429 | drm_mode_copy(&crtc->hwmode, &saved_hwmode); | |
f453ba04 DA |
430 | crtc->x = saved_x; |
431 | crtc->y = saved_y; | |
432 | } | |
433 | ||
434 | return ret; | |
435 | } | |
436 | EXPORT_SYMBOL(drm_crtc_helper_set_mode); | |
437 | ||
7fed7fa3 JMC |
438 | /** |
439 | * drm_crtc_helper_atomic_check() - Helper to check CRTC atomic-state | |
440 | * @crtc: CRTC to check | |
441 | * @state: atomic state object | |
442 | * | |
443 | * Provides a default CRTC-state check handler for CRTCs that only have | |
a0fce84c TZ |
444 | * one primary plane attached to it. This is often the case for the CRTC |
445 | * of simple framebuffers. | |
7fed7fa3 JMC |
446 | * |
447 | * RETURNS: | |
448 | * Zero on success, or an errno code otherwise. | |
449 | */ | |
450 | int drm_crtc_helper_atomic_check(struct drm_crtc *crtc, struct drm_atomic_state *state) | |
451 | { | |
452 | struct drm_crtc_state *new_crtc_state = drm_atomic_get_new_crtc_state(state, crtc); | |
453 | ||
454 | if (!new_crtc_state->enable) | |
455 | return 0; | |
456 | ||
457 | return drm_atomic_helper_check_crtc_primary_plane(new_crtc_state); | |
458 | } | |
459 | EXPORT_SYMBOL(drm_crtc_helper_atomic_check); | |
460 | ||
a74591d7 | 461 | static void |
6eebd6bb CW |
462 | drm_crtc_helper_disable(struct drm_crtc *crtc) |
463 | { | |
464 | struct drm_device *dev = crtc->dev; | |
465 | struct drm_connector *connector; | |
466 | struct drm_encoder *encoder; | |
467 | ||
468 | /* Decouple all encoders and their attached connectors from this crtc */ | |
6295d607 | 469 | drm_for_each_encoder(encoder, dev) { |
c36a3254 DV |
470 | struct drm_connector_list_iter conn_iter; |
471 | ||
6eebd6bb CW |
472 | if (encoder->crtc != crtc) |
473 | continue; | |
474 | ||
b982dab1 | 475 | drm_connector_list_iter_begin(dev, &conn_iter); |
c36a3254 | 476 | drm_for_each_connector_iter(connector, &conn_iter) { |
6eebd6bb CW |
477 | if (connector->encoder != encoder) |
478 | continue; | |
479 | ||
480 | connector->encoder = NULL; | |
a6ad6230 TR |
481 | |
482 | /* | |
483 | * drm_helper_disable_unused_functions() ought to be | |
484 | * doing this, but since we've decoupled the encoder | |
485 | * from the connector above, the required connection | |
486 | * between them is henceforth no longer available. | |
487 | */ | |
488 | connector->dpms = DRM_MODE_DPMS_OFF; | |
0955c125 DA |
489 | |
490 | /* we keep a reference while the encoder is bound */ | |
ad093607 | 491 | drm_connector_put(connector); |
6eebd6bb | 492 | } |
b982dab1 | 493 | drm_connector_list_iter_end(&conn_iter); |
6eebd6bb CW |
494 | } |
495 | ||
b182cc59 | 496 | __drm_helper_disable_unused_functions(dev); |
6eebd6bb CW |
497 | } |
498 | ||
a92462d6 JRS |
499 | /* |
500 | * For connectors that support multiple encoders, either the | |
501 | * .atomic_best_encoder() or .best_encoder() operation must be implemented. | |
502 | */ | |
503 | struct drm_encoder * | |
504 | drm_connector_get_single_encoder(struct drm_connector *connector) | |
505 | { | |
62afb4ad JRS |
506 | struct drm_encoder *encoder; |
507 | ||
fad8e251 | 508 | drm_WARN_ON(connector->dev, hweight32(connector->possible_encoders) > 1); |
62afb4ad JRS |
509 | drm_connector_for_each_possible_encoder(connector, encoder) |
510 | return encoder; | |
511 | ||
512 | return NULL; | |
a92462d6 JRS |
513 | } |
514 | ||
f453ba04 DA |
515 | /** |
516 | * drm_crtc_helper_set_config - set a new config from userspace | |
0d4ed4c8 | 517 | * @set: mode set configuration |
a4eff9aa | 518 | * @ctx: lock acquire context, not used here |
f453ba04 | 519 | * |
6806cdf9 DV |
520 | * The drm_crtc_helper_set_config() helper function implements the of |
521 | * &drm_crtc_funcs.set_config callback for drivers using the legacy CRTC | |
522 | * helpers. | |
2be94971 DV |
523 | * |
524 | * It first tries to locate the best encoder for each connector by calling the | |
6806cdf9 | 525 | * connector @drm_connector_helper_funcs.best_encoder helper operation. |
2be94971 DV |
526 | * |
527 | * After locating the appropriate encoders, the helper function will call the | |
528 | * mode_fixup encoder and CRTC helper operations to adjust the requested mode, | |
529 | * or reject it completely in which case an error will be returned to the | |
530 | * application. If the new configuration after mode adjustment is identical to | |
531 | * the current configuration the helper function will return without performing | |
532 | * any other operation. | |
533 | * | |
534 | * If the adjusted mode is identical to the current mode but changes to the | |
535 | * frame buffer need to be applied, the drm_crtc_helper_set_config() function | |
6806cdf9 | 536 | * will call the CRTC &drm_crtc_helper_funcs.mode_set_base helper operation. |
2be94971 DV |
537 | * |
538 | * If the adjusted mode differs from the current mode, or if the | |
539 | * ->mode_set_base() helper operation is not provided, the helper function | |
540 | * performs a full mode set sequence by calling the ->prepare(), ->mode_set() | |
541 | * and ->commit() CRTC and encoder helper operations, in that order. | |
542 | * Alternatively it can also use the dpms and disable helper operations. For | |
ea0dd85a | 543 | * details see &struct drm_crtc_helper_funcs and struct |
2be94971 DV |
544 | * &drm_encoder_helper_funcs. |
545 | * | |
546 | * This function is deprecated. New drivers must implement atomic modeset | |
547 | * support, for which this function is unsuitable. Instead drivers should use | |
548 | * drm_atomic_helper_set_config(). | |
f453ba04 | 549 | * |
3fcc42e0 DV |
550 | * Returns: |
551 | * Returns 0 on success, negative errno numbers on failure. | |
f453ba04 | 552 | */ |
a4eff9aa DV |
553 | int drm_crtc_helper_set_config(struct drm_mode_set *set, |
554 | struct drm_modeset_acquire_ctx *ctx) | |
f453ba04 DA |
555 | { |
556 | struct drm_device *dev; | |
93f55972 PZ |
557 | struct drm_crtc **save_encoder_crtcs, *new_crtc; |
558 | struct drm_encoder **save_connector_encoders, *new_encoder, *encoder; | |
4cb72b17 JB |
559 | bool mode_changed = false; /* if true do a full mode set */ |
560 | bool fb_changed = false; /* if true and !mode_changed just do a flip */ | |
93f55972 | 561 | struct drm_connector *connector; |
c36a3254 | 562 | struct drm_connector_list_iter conn_iter; |
f453ba04 | 563 | int count = 0, ro, fail = 0; |
be26a66d | 564 | const struct drm_crtc_helper_funcs *crtc_funcs; |
c5006cfe | 565 | struct drm_mode_set save_set; |
4a1b0714 | 566 | int ret; |
bf9dc102 | 567 | int i; |
f453ba04 | 568 | |
e58de880 DV |
569 | BUG_ON(!set); |
570 | BUG_ON(!set->crtc); | |
571 | BUG_ON(!set->crtc->helper_private); | |
f453ba04 | 572 | |
e58de880 DV |
573 | /* Enforce sane interface api - has been abused by the fb helper. */ |
574 | BUG_ON(!set->mode && set->fb); | |
575 | BUG_ON(set->fb && set->num_connectors == 0); | |
f453ba04 DA |
576 | |
577 | crtc_funcs = set->crtc->helper_private; | |
578 | ||
2b5ab0ee | 579 | dev = set->crtc->dev; |
fad8e251 JN |
580 | |
581 | drm_dbg_kms(dev, "\n"); | |
582 | ||
583 | drm_WARN_ON(dev, drm_drv_uses_atomic_modeset(dev)); | |
2b5ab0ee | 584 | |
ede3ff52 CW |
585 | if (!set->mode) |
586 | set->fb = NULL; | |
587 | ||
9440106b | 588 | if (set->fb) { |
fad8e251 JN |
589 | drm_dbg_kms(dev, "[CRTC:%d:%s] [FB:%d] #connectors=%d (x y) (%i %i)\n", |
590 | set->crtc->base.id, set->crtc->name, | |
591 | set->fb->base.id, | |
592 | (int)set->num_connectors, set->x, set->y); | |
9440106b | 593 | } else { |
fad8e251 JN |
594 | drm_dbg_kms(dev, "[CRTC:%d:%s] [NOFB]\n", |
595 | set->crtc->base.id, set->crtc->name); | |
a74591d7 TR |
596 | drm_crtc_helper_disable(set->crtc); |
597 | return 0; | |
9440106b | 598 | } |
f453ba04 | 599 | |
62ff94a5 DV |
600 | drm_warn_on_modeset_not_all_locked(dev); |
601 | ||
02ee4e94 IH |
602 | /* |
603 | * Allocate space for the backup of all (non-pointer) encoder and | |
604 | * connector data. | |
605 | */ | |
4b947b1c | 606 | save_encoder_crtcs = kcalloc(dev->mode_config.num_encoder, |
93f55972 PZ |
607 | sizeof(struct drm_crtc *), GFP_KERNEL); |
608 | if (!save_encoder_crtcs) | |
f453ba04 | 609 | return -ENOMEM; |
f453ba04 | 610 | |
4b947b1c | 611 | save_connector_encoders = kcalloc(dev->mode_config.num_connector, |
93f55972 PZ |
612 | sizeof(struct drm_encoder *), GFP_KERNEL); |
613 | if (!save_connector_encoders) { | |
614 | kfree(save_encoder_crtcs); | |
e67aae79 MM |
615 | return -ENOMEM; |
616 | } | |
617 | ||
02ee4e94 IH |
618 | /* |
619 | * Copy data. Note that driver private data is not affected. | |
e67aae79 MM |
620 | * Should anything bad happen only the expected state is |
621 | * restored, not the drivers personal bookkeeping. | |
622 | */ | |
e67aae79 | 623 | count = 0; |
6295d607 | 624 | drm_for_each_encoder(encoder, dev) { |
93f55972 | 625 | save_encoder_crtcs[count++] = encoder->crtc; |
e67aae79 MM |
626 | } |
627 | ||
628 | count = 0; | |
b982dab1 | 629 | drm_connector_list_iter_begin(dev, &conn_iter); |
c36a3254 | 630 | drm_for_each_connector_iter(connector, &conn_iter) |
93f55972 | 631 | save_connector_encoders[count++] = connector->encoder; |
b982dab1 | 632 | drm_connector_list_iter_end(&conn_iter); |
e67aae79 | 633 | |
c5006cfe JB |
634 | save_set.crtc = set->crtc; |
635 | save_set.mode = &set->crtc->mode; | |
636 | save_set.x = set->crtc->x; | |
637 | save_set.y = set->crtc->y; | |
f4510a27 | 638 | save_set.fb = set->crtc->primary->fb; |
c5006cfe | 639 | |
f453ba04 DA |
640 | /* We should be able to check here if the fb has the same properties |
641 | * and then just flip_or_move it */ | |
f4510a27 | 642 | if (set->crtc->primary->fb != set->fb) { |
712531bf | 643 | /* If we have no fb then treat it as a full mode set */ |
f4510a27 | 644 | if (set->crtc->primary->fb == NULL) { |
fad8e251 JN |
645 | drm_dbg_kms(dev, "[CRTC:%d:%s] no fb, full mode set\n", |
646 | set->crtc->base.id, set->crtc->name); | |
712531bf | 647 | mode_changed = true; |
dbd4d576 | 648 | } else if (set->fb->format != set->crtc->primary->fb->format) { |
ce83adf7 | 649 | mode_changed = true; |
8dff4742 | 650 | } else |
712531bf | 651 | fb_changed = true; |
f453ba04 DA |
652 | } |
653 | ||
654 | if (set->x != set->crtc->x || set->y != set->crtc->y) | |
712531bf | 655 | fb_changed = true; |
f453ba04 | 656 | |
2deafc7e | 657 | if (!drm_mode_equal(set->mode, &set->crtc->mode)) { |
fad8e251 JN |
658 | drm_dbg_kms(dev, "[CRTC:%d:%s] modes are different, full mode set:\n", |
659 | set->crtc->base.id, set->crtc->name); | |
96a91515 JN |
660 | drm_dbg_kms(dev, DRM_MODE_FMT "\n", DRM_MODE_ARG(&set->crtc->mode)); |
661 | drm_dbg_kms(dev, DRM_MODE_FMT "\n", DRM_MODE_ARG(set->mode)); | |
712531bf | 662 | mode_changed = true; |
f453ba04 DA |
663 | } |
664 | ||
fffc5f59 PZ |
665 | /* take a reference on all unbound connectors in set, reuse the |
666 | * already taken reference for bound connectors | |
667 | */ | |
0955c125 | 668 | for (ro = 0; ro < set->num_connectors; ro++) { |
fffc5f59 PZ |
669 | if (set->connectors[ro]->encoder) |
670 | continue; | |
ad093607 | 671 | drm_connector_get(set->connectors[ro]); |
0955c125 DA |
672 | } |
673 | ||
f453ba04 DA |
674 | /* a) traverse passed in connector list and get encoders for them */ |
675 | count = 0; | |
b982dab1 | 676 | drm_connector_list_iter_begin(dev, &conn_iter); |
c36a3254 | 677 | drm_for_each_connector_iter(connector, &conn_iter) { |
be26a66d | 678 | const struct drm_connector_helper_funcs *connector_funcs = |
f453ba04 | 679 | connector->helper_private; |
f453ba04 DA |
680 | new_encoder = connector->encoder; |
681 | for (ro = 0; ro < set->num_connectors; ro++) { | |
682 | if (set->connectors[ro] == connector) { | |
a92462d6 JRS |
683 | if (connector_funcs->best_encoder) |
684 | new_encoder = connector_funcs->best_encoder(connector); | |
685 | else | |
686 | new_encoder = drm_connector_get_single_encoder(connector); | |
687 | ||
f453ba04 DA |
688 | /* if we can't get an encoder for a connector |
689 | we are setting now - then fail */ | |
690 | if (new_encoder == NULL) | |
691 | /* don't break so fail path works correct */ | |
692 | fail = 1; | |
25f397a4 DV |
693 | |
694 | if (connector->dpms != DRM_MODE_DPMS_ON) { | |
fad8e251 JN |
695 | drm_dbg_kms(dev, "[CONNECTOR:%d:%s] DPMS not on, full mode switch\n", |
696 | connector->base.id, connector->name); | |
25f397a4 DV |
697 | mode_changed = true; |
698 | } | |
177cf92d DV |
699 | |
700 | break; | |
f453ba04 DA |
701 | } |
702 | } | |
703 | ||
704 | if (new_encoder != connector->encoder) { | |
fad8e251 JN |
705 | drm_dbg_kms(dev, "[CONNECTOR:%d:%s] encoder changed, full mode switch\n", |
706 | connector->base.id, connector->name); | |
712531bf | 707 | mode_changed = true; |
ff846ab7 MM |
708 | /* If the encoder is reused for another connector, then |
709 | * the appropriate crtc will be set later. | |
710 | */ | |
ff6fdbed MM |
711 | if (connector->encoder) |
712 | connector->encoder->crtc = NULL; | |
f453ba04 DA |
713 | connector->encoder = new_encoder; |
714 | } | |
715 | } | |
b982dab1 | 716 | drm_connector_list_iter_end(&conn_iter); |
f453ba04 DA |
717 | |
718 | if (fail) { | |
719 | ret = -EINVAL; | |
e67aae79 | 720 | goto fail; |
f453ba04 DA |
721 | } |
722 | ||
723 | count = 0; | |
b982dab1 | 724 | drm_connector_list_iter_begin(dev, &conn_iter); |
c36a3254 | 725 | drm_for_each_connector_iter(connector, &conn_iter) { |
f453ba04 DA |
726 | if (!connector->encoder) |
727 | continue; | |
728 | ||
f453ba04 DA |
729 | if (connector->encoder->crtc == set->crtc) |
730 | new_crtc = NULL; | |
731 | else | |
732 | new_crtc = connector->encoder->crtc; | |
733 | ||
734 | for (ro = 0; ro < set->num_connectors; ro++) { | |
735 | if (set->connectors[ro] == connector) | |
736 | new_crtc = set->crtc; | |
737 | } | |
7bec756c JB |
738 | |
739 | /* Make sure the new CRTC will work with the encoder */ | |
740 | if (new_crtc && | |
741 | !drm_encoder_crtc_ok(connector->encoder, new_crtc)) { | |
742 | ret = -EINVAL; | |
b982dab1 | 743 | drm_connector_list_iter_end(&conn_iter); |
e67aae79 | 744 | goto fail; |
7bec756c | 745 | } |
f453ba04 | 746 | if (new_crtc != connector->encoder->crtc) { |
fad8e251 JN |
747 | drm_dbg_kms(dev, "[CONNECTOR:%d:%s] CRTC changed, full mode switch\n", |
748 | connector->base.id, connector->name); | |
712531bf | 749 | mode_changed = true; |
f453ba04 DA |
750 | connector->encoder->crtc = new_crtc; |
751 | } | |
9440106b | 752 | if (new_crtc) { |
fad8e251 JN |
753 | drm_dbg_kms(dev, "[CONNECTOR:%d:%s] to [CRTC:%d:%s]\n", |
754 | connector->base.id, connector->name, | |
755 | new_crtc->base.id, new_crtc->name); | |
9440106b | 756 | } else { |
fad8e251 JN |
757 | drm_dbg_kms(dev, "[CONNECTOR:%d:%s] to [NOCRTC]\n", |
758 | connector->base.id, connector->name); | |
9440106b | 759 | } |
f453ba04 | 760 | } |
b982dab1 | 761 | drm_connector_list_iter_end(&conn_iter); |
f453ba04 DA |
762 | |
763 | /* mode_set_base is not a required function */ | |
712531bf JB |
764 | if (fb_changed && !crtc_funcs->mode_set_base) |
765 | mode_changed = true; | |
f453ba04 | 766 | |
712531bf | 767 | if (mode_changed) { |
48b1f5dd | 768 | if (drm_helper_crtc_in_use(set->crtc)) { |
96a91515 JN |
769 | drm_dbg_kms(dev, "[CRTC:%d:%s] attempting to set mode from userspace: " DRM_MODE_FMT "\n", |
770 | set->crtc->base.id, set->crtc->name, DRM_MODE_ARG(set->mode)); | |
f4510a27 | 771 | set->crtc->primary->fb = set->fb; |
f453ba04 | 772 | if (!drm_crtc_helper_set_mode(set->crtc, set->mode, |
3c4fdcfb | 773 | set->x, set->y, |
bec2eac3 | 774 | save_set.fb)) { |
fad8e251 JN |
775 | drm_err(dev, "[CRTC:%d:%s] failed to set mode\n", |
776 | set->crtc->base.id, set->crtc->name); | |
f4510a27 | 777 | set->crtc->primary->fb = save_set.fb; |
f453ba04 | 778 | ret = -EINVAL; |
e67aae79 | 779 | goto fail; |
f453ba04 | 780 | } |
fad8e251 JN |
781 | drm_dbg_kms(dev, "[CRTC:%d:%s] Setting connector DPMS state to on\n", |
782 | set->crtc->base.id, set->crtc->name); | |
25f397a4 | 783 | for (i = 0; i < set->num_connectors; i++) { |
fad8e251 JN |
784 | drm_dbg_kms(dev, "\t[CONNECTOR:%d:%s] set DPMS on\n", set->connectors[i]->base.id, |
785 | set->connectors[i]->name); | |
25f397a4 DV |
786 | set->connectors[i]->funcs->dpms(set->connectors[i], DRM_MODE_DPMS_ON); |
787 | } | |
f453ba04 | 788 | } |
b182cc59 | 789 | __drm_helper_disable_unused_functions(dev); |
712531bf | 790 | } else if (fb_changed) { |
9b1596af BS |
791 | set->crtc->x = set->x; |
792 | set->crtc->y = set->y; | |
f4510a27 | 793 | set->crtc->primary->fb = set->fb; |
5c3b82e2 | 794 | ret = crtc_funcs->mode_set_base(set->crtc, |
bec2eac3 | 795 | set->x, set->y, save_set.fb); |
0ba41e44 | 796 | if (ret != 0) { |
fbce4064 IH |
797 | set->crtc->x = save_set.x; |
798 | set->crtc->y = save_set.y; | |
f4510a27 | 799 | set->crtc->primary->fb = save_set.fb; |
e67aae79 | 800 | goto fail; |
0ba41e44 | 801 | } |
f453ba04 DA |
802 | } |
803 | ||
93f55972 PZ |
804 | kfree(save_connector_encoders); |
805 | kfree(save_encoder_crtcs); | |
f453ba04 DA |
806 | return 0; |
807 | ||
e67aae79 MM |
808 | fail: |
809 | /* Restore all previous data. */ | |
e67aae79 | 810 | count = 0; |
6295d607 | 811 | drm_for_each_encoder(encoder, dev) { |
93f55972 | 812 | encoder->crtc = save_encoder_crtcs[count++]; |
e62fb64e | 813 | } |
e67aae79 | 814 | |
f453ba04 | 815 | count = 0; |
b982dab1 | 816 | drm_connector_list_iter_begin(dev, &conn_iter); |
c36a3254 | 817 | drm_for_each_connector_iter(connector, &conn_iter) |
93f55972 | 818 | connector->encoder = save_connector_encoders[count++]; |
b982dab1 | 819 | drm_connector_list_iter_end(&conn_iter); |
e67aae79 | 820 | |
fffc5f59 PZ |
821 | /* after fail drop reference on all unbound connectors in set, let |
822 | * bound connectors keep their reference | |
823 | */ | |
0955c125 | 824 | for (ro = 0; ro < set->num_connectors; ro++) { |
fffc5f59 PZ |
825 | if (set->connectors[ro]->encoder) |
826 | continue; | |
ad093607 | 827 | drm_connector_put(set->connectors[ro]); |
0955c125 DA |
828 | } |
829 | ||
c5006cfe JB |
830 | /* Try to restore the config */ |
831 | if (mode_changed && | |
832 | !drm_crtc_helper_set_mode(save_set.crtc, save_set.mode, save_set.x, | |
833 | save_set.y, save_set.fb)) | |
fad8e251 | 834 | drm_err(dev, "failed to restore config after modeset failure\n"); |
c5006cfe | 835 | |
93f55972 PZ |
836 | kfree(save_connector_encoders); |
837 | kfree(save_encoder_crtcs); | |
f453ba04 DA |
838 | return ret; |
839 | } | |
840 | EXPORT_SYMBOL(drm_crtc_helper_set_config); | |
841 | ||
c9fb15f6 KP |
842 | static int drm_helper_choose_encoder_dpms(struct drm_encoder *encoder) |
843 | { | |
844 | int dpms = DRM_MODE_DPMS_OFF; | |
845 | struct drm_connector *connector; | |
c36a3254 | 846 | struct drm_connector_list_iter conn_iter; |
c9fb15f6 KP |
847 | struct drm_device *dev = encoder->dev; |
848 | ||
b982dab1 | 849 | drm_connector_list_iter_begin(dev, &conn_iter); |
c36a3254 | 850 | drm_for_each_connector_iter(connector, &conn_iter) |
c9fb15f6 KP |
851 | if (connector->encoder == encoder) |
852 | if (connector->dpms < dpms) | |
853 | dpms = connector->dpms; | |
b982dab1 | 854 | drm_connector_list_iter_end(&conn_iter); |
c36a3254 | 855 | |
c9fb15f6 KP |
856 | return dpms; |
857 | } | |
858 | ||
3b336ec4 SP |
859 | /* Helper which handles bridge ordering around encoder dpms */ |
860 | static void drm_helper_encoder_dpms(struct drm_encoder *encoder, int mode) | |
861 | { | |
be26a66d | 862 | const struct drm_encoder_helper_funcs *encoder_funcs; |
3b336ec4 | 863 | |
75229eca NT |
864 | encoder_funcs = encoder->helper_private; |
865 | if (!encoder_funcs) | |
866 | return; | |
867 | ||
3b336ec4 SP |
868 | if (encoder_funcs->dpms) |
869 | encoder_funcs->dpms(encoder, mode); | |
3b336ec4 SP |
870 | } |
871 | ||
c9fb15f6 KP |
872 | static int drm_helper_choose_crtc_dpms(struct drm_crtc *crtc) |
873 | { | |
874 | int dpms = DRM_MODE_DPMS_OFF; | |
875 | struct drm_connector *connector; | |
c36a3254 | 876 | struct drm_connector_list_iter conn_iter; |
c9fb15f6 KP |
877 | struct drm_device *dev = crtc->dev; |
878 | ||
b982dab1 | 879 | drm_connector_list_iter_begin(dev, &conn_iter); |
c36a3254 | 880 | drm_for_each_connector_iter(connector, &conn_iter) |
c9fb15f6 KP |
881 | if (connector->encoder && connector->encoder->crtc == crtc) |
882 | if (connector->dpms < dpms) | |
883 | dpms = connector->dpms; | |
b982dab1 | 884 | drm_connector_list_iter_end(&conn_iter); |
c36a3254 | 885 | |
c9fb15f6 KP |
886 | return dpms; |
887 | } | |
888 | ||
889 | /** | |
0d4ed4c8 DV |
890 | * drm_helper_connector_dpms() - connector dpms helper implementation |
891 | * @connector: affected connector | |
892 | * @mode: DPMS mode | |
c9fb15f6 | 893 | * |
6806cdf9 DV |
894 | * The drm_helper_connector_dpms() helper function implements the |
895 | * &drm_connector_funcs.dpms callback for drivers using the legacy CRTC | |
896 | * helpers. | |
2be94971 DV |
897 | * |
898 | * This is the main helper function provided by the CRTC helper framework for | |
0d4ed4c8 | 899 | * implementing the DPMS connector attribute. It computes the new desired DPMS |
6806cdf9 DV |
900 | * state for all encoders and CRTCs in the output mesh and calls the |
901 | * &drm_crtc_helper_funcs.dpms and &drm_encoder_helper_funcs.dpms callbacks | |
902 | * provided by the driver. | |
2be94971 DV |
903 | * |
904 | * This function is deprecated. New drivers must implement atomic modeset | |
144a7999 | 905 | * support, where DPMS is handled in the DRM core. |
9a69a9ac ML |
906 | * |
907 | * Returns: | |
908 | * Always returns 0. | |
c9fb15f6 | 909 | */ |
9a69a9ac | 910 | int drm_helper_connector_dpms(struct drm_connector *connector, int mode) |
c9fb15f6 KP |
911 | { |
912 | struct drm_encoder *encoder = connector->encoder; | |
913 | struct drm_crtc *crtc = encoder ? encoder->crtc : NULL; | |
3b336ec4 | 914 | int old_dpms, encoder_dpms = DRM_MODE_DPMS_OFF; |
c9fb15f6 | 915 | |
fad8e251 | 916 | drm_WARN_ON(connector->dev, drm_drv_uses_atomic_modeset(connector->dev)); |
2b5ab0ee | 917 | |
c9fb15f6 | 918 | if (mode == connector->dpms) |
9a69a9ac | 919 | return 0; |
c9fb15f6 KP |
920 | |
921 | old_dpms = connector->dpms; | |
922 | connector->dpms = mode; | |
923 | ||
3b336ec4 SP |
924 | if (encoder) |
925 | encoder_dpms = drm_helper_choose_encoder_dpms(encoder); | |
926 | ||
c9fb15f6 KP |
927 | /* from off to on, do crtc then encoder */ |
928 | if (mode < old_dpms) { | |
929 | if (crtc) { | |
be26a66d | 930 | const struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private; |
948de842 | 931 | |
c9fb15f6 KP |
932 | if (crtc_funcs->dpms) |
933 | (*crtc_funcs->dpms) (crtc, | |
934 | drm_helper_choose_crtc_dpms(crtc)); | |
935 | } | |
3b336ec4 SP |
936 | if (encoder) |
937 | drm_helper_encoder_dpms(encoder, encoder_dpms); | |
c9fb15f6 KP |
938 | } |
939 | ||
940 | /* from on to off, do encoder then crtc */ | |
941 | if (mode > old_dpms) { | |
3b336ec4 SP |
942 | if (encoder) |
943 | drm_helper_encoder_dpms(encoder, encoder_dpms); | |
c9fb15f6 | 944 | if (crtc) { |
be26a66d | 945 | const struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private; |
948de842 | 946 | |
c9fb15f6 KP |
947 | if (crtc_funcs->dpms) |
948 | (*crtc_funcs->dpms) (crtc, | |
949 | drm_helper_choose_crtc_dpms(crtc)); | |
950 | } | |
951 | } | |
952 | ||
9a69a9ac | 953 | return 0; |
c9fb15f6 KP |
954 | } |
955 | EXPORT_SYMBOL(drm_helper_connector_dpms); | |
956 | ||
aa4cd910 DV |
957 | /** |
958 | * drm_helper_resume_force_mode - force-restore mode setting configuration | |
959 | * @dev: drm_device which should be restored | |
960 | * | |
961 | * Drivers which use the mode setting helpers can use this function to | |
962 | * force-restore the mode setting configuration e.g. on resume or when something | |
963 | * else might have trampled over the hw state (like some overzealous old BIOSen | |
964 | * tended to do). | |
00d762cb DV |
965 | * |
966 | * This helper doesn't provide a error return value since restoring the old | |
967 | * config should never fail due to resource allocation issues since the driver | |
968 | * has successfully set the restored configuration already. Hence this should | |
969 | * boil down to the equivalent of a few dpms on calls, which also don't provide | |
970 | * an error code. | |
971 | * | |
972 | * Drivers where simply restoring an old configuration again might fail (e.g. | |
973 | * due to slight differences in allocating shared resources when the | |
974 | * configuration is restored in a different order than when userspace set it up) | |
975 | * need to use their own restore logic. | |
14942760 TR |
976 | * |
977 | * This function is deprecated. New drivers should implement atomic mode- | |
978 | * setting and use the atomic suspend/resume helpers. | |
979 | * | |
980 | * See also: | |
981 | * drm_atomic_helper_suspend(), drm_atomic_helper_resume() | |
aa4cd910 | 982 | */ |
00d762cb | 983 | void drm_helper_resume_force_mode(struct drm_device *dev) |
f453ba04 DA |
984 | { |
985 | struct drm_crtc *crtc; | |
89347bb8 | 986 | struct drm_encoder *encoder; |
be26a66d | 987 | const struct drm_crtc_helper_funcs *crtc_funcs; |
00d762cb DV |
988 | int encoder_dpms; |
989 | bool ret; | |
f453ba04 | 990 | |
fad8e251 | 991 | drm_WARN_ON(dev, drm_drv_uses_atomic_modeset(dev)); |
2b5ab0ee | 992 | |
76fd2c37 | 993 | drm_modeset_lock_all(dev); |
6295d607 | 994 | drm_for_each_crtc(crtc, dev) { |
f453ba04 DA |
995 | |
996 | if (!crtc->enabled) | |
997 | continue; | |
998 | ||
3c4fdcfb | 999 | ret = drm_crtc_helper_set_mode(crtc, &crtc->mode, |
f4510a27 | 1000 | crtc->x, crtc->y, crtc->primary->fb); |
f453ba04 | 1001 | |
00d762cb | 1002 | /* Restoring the old config should never fail! */ |
f453ba04 | 1003 | if (ret == false) |
fad8e251 | 1004 | drm_err(dev, "failed to set mode on crtc %p\n", crtc); |
89347bb8 DJ |
1005 | |
1006 | /* Turn off outputs that were already powered off */ | |
1007 | if (drm_helper_choose_crtc_dpms(crtc)) { | |
6295d607 | 1008 | drm_for_each_encoder(encoder, dev) { |
89347bb8 DJ |
1009 | |
1010 | if(encoder->crtc != crtc) | |
1011 | continue; | |
1012 | ||
3b336ec4 SP |
1013 | encoder_dpms = drm_helper_choose_encoder_dpms( |
1014 | encoder); | |
1015 | ||
1016 | drm_helper_encoder_dpms(encoder, encoder_dpms); | |
89347bb8 | 1017 | } |
817e631e CW |
1018 | |
1019 | crtc_funcs = crtc->helper_private; | |
1020 | if (crtc_funcs->dpms) | |
1021 | (*crtc_funcs->dpms) (crtc, | |
1022 | drm_helper_choose_crtc_dpms(crtc)); | |
89347bb8 | 1023 | } |
f453ba04 | 1024 | } |
00d762cb | 1025 | |
af4fcb57 | 1026 | /* disable the unused connectors while restoring the modesetting */ |
b182cc59 | 1027 | __drm_helper_disable_unused_functions(dev); |
76fd2c37 | 1028 | drm_modeset_unlock_all(dev); |
f453ba04 DA |
1029 | } |
1030 | EXPORT_SYMBOL(drm_helper_resume_force_mode); | |
c2d88e06 DV |
1031 | |
1032 | /** | |
1033 | * drm_helper_force_disable_all - Forcibly turn off all enabled CRTCs | |
1034 | * @dev: DRM device whose CRTCs to turn off | |
1035 | * | |
1036 | * Drivers may want to call this on unload to ensure that all displays are | |
1037 | * unlit and the GPU is in a consistent, low power state. Takes modeset locks. | |
1038 | * | |
1039 | * Note: This should only be used by non-atomic legacy drivers. For an atomic | |
1040 | * version look at drm_atomic_helper_shutdown(). | |
1041 | * | |
1042 | * Returns: | |
1043 | * Zero on success, error code on failure. | |
1044 | */ | |
1045 | int drm_helper_force_disable_all(struct drm_device *dev) | |
1046 | { | |
1047 | struct drm_crtc *crtc; | |
1048 | int ret = 0; | |
1049 | ||
76fd2c37 | 1050 | drm_modeset_lock_all(dev); |
c2d88e06 DV |
1051 | drm_for_each_crtc(crtc, dev) |
1052 | if (crtc->enabled) { | |
1053 | struct drm_mode_set set = { | |
1054 | .crtc = crtc, | |
1055 | }; | |
1056 | ||
1057 | ret = drm_mode_set_config_internal(&set); | |
1058 | if (ret) | |
1059 | goto out; | |
1060 | } | |
1061 | out: | |
76fd2c37 | 1062 | drm_modeset_unlock_all(dev); |
c2d88e06 DV |
1063 | return ret; |
1064 | } | |
1065 | EXPORT_SYMBOL(drm_helper_force_disable_all); |