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
32#include <linux/kernel.h>
33#include <linux/export.h>
34#include <linux/module.h>
35#include <linux/moduleparam.h>
36#include <asm/param.h>
37#include <asm/bug.h>
38
39#include <drm/drmP.h>
40#include <drm/drm_crtc.h>
41#include <drm/drm_fourcc.h>
42#include <drm/drm_crtc_helper.h>
43#ifndef __NetBSD__
44#include <drm/drm_fb_helper.h>
45#endif
46#include <drm/drm_edid.h>
47
48MODULE_AUTHOR("David Airlie, Jesse Barnes");
49MODULE_DESCRIPTION("DRM KMS helper");
50MODULE_LICENSE("GPL and additional rights");
51
52/**
53 * drm_helper_move_panel_connectors_to_head() - move panels to the front in the
54 * connector list
55 * @dev: drm device to operate on
56 *
57 * Some userspace presumes that the first connected connector is the main
58 * display, where it's supposed to display e.g. the login screen. For
59 * laptops, this should be the main panel. Use this function to sort all
60 * (eDP/LVDS) panels to the front of the connector list, instead of
61 * painstakingly trying to initialize them in the right order.
62 */
63void drm_helper_move_panel_connectors_to_head(struct drm_device *dev)
64{
65 struct drm_connector *connector, *tmp;
66 struct list_head panel_list;
67
68 INIT_LIST_HEAD(&panel_list);
69
70 list_for_each_entry_safe(connector, tmp,
71 &dev->mode_config.connector_list, head) {
72 if (connector->connector_type == DRM_MODE_CONNECTOR_LVDS ||
73 connector->connector_type == DRM_MODE_CONNECTOR_eDP)
74 list_move_tail(&connector->head, &panel_list);
75 }
76
77 list_splice(&panel_list, &dev->mode_config.connector_list);
78}
79EXPORT_SYMBOL(drm_helper_move_panel_connectors_to_head);
80
81/**
82 * drm_helper_encoder_in_use - check if a given encoder is in use
83 * @encoder: encoder to check
84 *
85 * Checks whether @encoder is with the current mode setting output configuration
86 * in use by any connector. This doesn't mean that it is actually enabled since
87 * the DPMS state is tracked separately.
88 *
89 * Returns:
90 * True if @encoder is used, false otherwise.
91 */
92bool drm_helper_encoder_in_use(struct drm_encoder *encoder)
93{
94 struct drm_connector *connector;
95 struct drm_device *dev = encoder->dev;
96
97 /*
98 * We can expect this mutex to be locked if we are not panicking.
99 * Locking is currently fubar in the panic handler.
100 */
101 if (!oops_in_progress)
102 WARN_ON(!mutex_is_locked(&dev->mode_config.mutex));
103
104 list_for_each_entry(connector, &dev->mode_config.connector_list, head)
105 if (connector->encoder == encoder)
106 return true;
107 return false;
108}
109EXPORT_SYMBOL(drm_helper_encoder_in_use);
110
111/**
112 * drm_helper_crtc_in_use - check if a given CRTC is in a mode_config
113 * @crtc: CRTC to check
114 *
115 * Checks whether @crtc is with the current mode setting output configuration
116 * in use by any connector. This doesn't mean that it is actually enabled since
117 * the DPMS state is tracked separately.
118 *
119 * Returns:
120 * True if @crtc is used, false otherwise.
121 */
122bool drm_helper_crtc_in_use(struct drm_crtc *crtc)
123{
124 struct drm_encoder *encoder;
125 struct drm_device *dev = crtc->dev;
126
127 /*
128 * We can expect this mutex to be locked if we are not panicking.
129 * Locking is currently fubar in the panic handler.
130 */
131 if (!oops_in_progress)
132 WARN_ON(!mutex_is_locked(&dev->mode_config.mutex));
133
134 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head)
135 if (encoder->crtc == crtc && drm_helper_encoder_in_use(encoder))
136 return true;
137 return false;
138}
139EXPORT_SYMBOL(drm_helper_crtc_in_use);
140
141static void
142drm_encoder_disable(struct drm_encoder *encoder)
143{
144 struct drm_encoder_helper_funcs *encoder_funcs = encoder->helper_private;
145
146 if (encoder->bridge)
147 encoder->bridge->funcs->disable(encoder->bridge);
148
149 if (encoder_funcs->disable)
150 (*encoder_funcs->disable)(encoder);
151 else
152 (*encoder_funcs->dpms)(encoder, DRM_MODE_DPMS_OFF);
153
154 if (encoder->bridge)
155 encoder->bridge->funcs->post_disable(encoder->bridge);
156}
157
158static void __drm_helper_disable_unused_functions(struct drm_device *dev)
159{
160 struct drm_encoder *encoder;
161 struct drm_connector *connector;
162 struct drm_crtc *crtc;
163
164 drm_warn_on_modeset_not_all_locked(dev);
165
166 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
167 if (!connector->encoder)
168 continue;
169 }
170
171 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
172 if (!drm_helper_encoder_in_use(encoder)) {
173 drm_encoder_disable(encoder);
174 /* disconnector encoder from any connector */
175 encoder->crtc = NULL;
176 }
177 }
178
179 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
180 struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
181 crtc->enabled = drm_helper_crtc_in_use(crtc);
182 if (!crtc->enabled) {
183 if (crtc_funcs->disable)
184 (*crtc_funcs->disable)(crtc);
185 else
186 (*crtc_funcs->dpms)(crtc, DRM_MODE_DPMS_OFF);
187 crtc->primary->fb = NULL;
188 }
189 }
190}
191
192/**
193 * drm_helper_disable_unused_functions - disable unused objects
194 * @dev: DRM device
195 *
196 * This function walks through the entire mode setting configuration of @dev. It
197 * will remove any crtc links of unused encoders and encoder links of
198 * disconnected connectors. Then it will disable all unused encoders and crtcs
199 * either by calling their disable callback if available or by calling their
200 * dpms callback with DRM_MODE_DPMS_OFF.
201 */
202void drm_helper_disable_unused_functions(struct drm_device *dev)
203{
204 drm_modeset_lock_all(dev);
205 __drm_helper_disable_unused_functions(dev);
206 drm_modeset_unlock_all(dev);
207}
208EXPORT_SYMBOL(drm_helper_disable_unused_functions);
209
210/*
211 * Check the CRTC we're going to map each output to vs. its current
212 * CRTC. If they don't match, we have to disable the output and the CRTC
213 * since the driver will have to re-route things.
214 */
215static void
216drm_crtc_prepare_encoders(struct drm_device *dev)
217{
218 struct drm_encoder_helper_funcs *encoder_funcs;
219 struct drm_encoder *encoder;
220
221 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
222 encoder_funcs = encoder->helper_private;
223 /* Disable unused encoders */
224 if (encoder->crtc == NULL)
225 drm_encoder_disable(encoder);
226 /* Disable encoders whose CRTC is about to change */
227 if (encoder_funcs->get_crtc &&
228 encoder->crtc != (*encoder_funcs->get_crtc)(encoder))
229 drm_encoder_disable(encoder);
230 }
231}
232
233/**
234 * drm_crtc_helper_set_mode - internal helper to set a mode
235 * @crtc: CRTC to program
236 * @mode: mode to use
237 * @x: horizontal offset into the surface
238 * @y: vertical offset into the surface
239 * @old_fb: old framebuffer, for cleanup
240 *
241 * Try to set @mode on @crtc. Give @crtc and its associated connectors a chance
242 * to fixup or reject the mode prior to trying to set it. This is an internal
243 * helper that drivers could e.g. use to update properties that require the
244 * entire output pipe to be disabled and re-enabled in a new configuration. For
245 * example for changing whether audio is enabled on a hdmi link or for changing
246 * panel fitter or dither attributes. It is also called by the
247 * drm_crtc_helper_set_config() helper function to drive the mode setting
248 * sequence.
249 *
250 * Returns:
251 * True if the mode was set successfully, false otherwise.
252 */
253bool drm_crtc_helper_set_mode(struct drm_crtc *crtc,
254 struct drm_display_mode *mode,
255 int x, int y,
256 struct drm_framebuffer *old_fb)
257{
258 struct drm_device *dev = crtc->dev;
259 struct drm_display_mode *adjusted_mode, saved_mode;
260 struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
261 struct drm_encoder_helper_funcs *encoder_funcs;
262 int saved_x, saved_y;
263 bool saved_enabled;
264 struct drm_encoder *encoder;
265 bool ret = true;
266
267 drm_warn_on_modeset_not_all_locked(dev);
268
269 saved_enabled = crtc->enabled;
270 crtc->enabled = drm_helper_crtc_in_use(crtc);
271 if (!crtc->enabled)
272 return true;
273
274 adjusted_mode = drm_mode_duplicate(dev, mode);
275 if (!adjusted_mode) {
276 crtc->enabled = saved_enabled;
277 return false;
278 }
279
280 saved_mode = crtc->mode;
281 saved_x = crtc->x;
282 saved_y = crtc->y;
283
284 /* Update crtc values up front so the driver can rely on them for mode
285 * setting.
286 */
287 crtc->mode = *mode;
288 crtc->x = x;
289 crtc->y = y;
290
291 /* Pass our mode to the connectors and the CRTC to give them a chance to
292 * adjust it according to limitations or connector properties, and also
293 * a chance to reject the mode entirely.
294 */
295 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
296
297 if (encoder->crtc != crtc)
298 continue;
299
300 if (encoder->bridge && encoder->bridge->funcs->mode_fixup) {
301 ret = encoder->bridge->funcs->mode_fixup(
302 encoder->bridge, mode, adjusted_mode);
303 if (!ret) {
304 DRM_DEBUG_KMS("Bridge fixup failed\n");
305 goto done;
306 }
307 }
308
309 encoder_funcs = encoder->helper_private;
310 if (!(ret = encoder_funcs->mode_fixup(encoder, mode,
311 adjusted_mode))) {
312 DRM_DEBUG_KMS("Encoder fixup failed\n");
313 goto done;
314 }
315 }
316
317 if (!(ret = crtc_funcs->mode_fixup(crtc, mode, adjusted_mode))) {
318 DRM_DEBUG_KMS("CRTC fixup failed\n");
319 goto done;
320 }
321 DRM_DEBUG_KMS("[CRTC:%d]\n", crtc->base.id);
322
323 /* Prepare the encoders and CRTCs before setting the mode. */
324 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
325
326 if (encoder->crtc != crtc)
327 continue;
328
329 if (encoder->bridge)
330 encoder->bridge->funcs->disable(encoder->bridge);
331
332 encoder_funcs = encoder->helper_private;
333 /* Disable the encoders as the first thing we do. */
334 encoder_funcs->prepare(encoder);
335
336 if (encoder->bridge)
337 encoder->bridge->funcs->post_disable(encoder->bridge);
338 }
339
340 drm_crtc_prepare_encoders(dev);
341
342 crtc_funcs->prepare(crtc);
343
344 /* Set up the DPLL and any encoders state that needs to adjust or depend
345 * on the DPLL.
346 */
347 ret = !crtc_funcs->mode_set(crtc, mode, adjusted_mode, x, y, old_fb);
348 if (!ret)
349 goto done;
350
351 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
352
353 if (encoder->crtc != crtc)
354 continue;
355
356 DRM_DEBUG_KMS("[ENCODER:%d:%s] set [MODE:%d:%s]\n",
357 encoder->base.id, drm_get_encoder_name(encoder),
358 mode->base.id, mode->name);
359 encoder_funcs = encoder->helper_private;
360 encoder_funcs->mode_set(encoder, mode, adjusted_mode);
361
362 if (encoder->bridge && encoder->bridge->funcs->mode_set)
363 encoder->bridge->funcs->mode_set(encoder->bridge, mode,
364 adjusted_mode);
365 }
366
367 /* Now enable the clocks, plane, pipe, and connectors that we set up. */
368 crtc_funcs->commit(crtc);
369
370 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
371
372 if (encoder->crtc != crtc)
373 continue;
374
375 if (encoder->bridge)
376 encoder->bridge->funcs->pre_enable(encoder->bridge);
377
378 encoder_funcs = encoder->helper_private;
379 encoder_funcs->commit(encoder);
380
381 if (encoder->bridge)
382 encoder->bridge->funcs->enable(encoder->bridge);
383 }
384
385 /* Store real post-adjustment hardware mode. */
386 crtc->hwmode = *adjusted_mode;
387
388 /* Calculate and store various constants which
389 * are later needed by vblank and swap-completion
390 * timestamping. They are derived from true hwmode.
391 */
392 drm_calc_timestamping_constants(crtc, &crtc->hwmode);
393
394 /* FIXME: add subpixel order */
395done:
396 drm_mode_destroy(dev, adjusted_mode);
397 if (!ret) {
398 crtc->enabled = saved_enabled;
399 crtc->mode = saved_mode;
400 crtc->x = saved_x;
401 crtc->y = saved_y;
402 }
403
404 return ret;
405}
406EXPORT_SYMBOL(drm_crtc_helper_set_mode);
407
408
409static int
410drm_crtc_helper_disable(struct drm_crtc *crtc)
411{
412 struct drm_device *dev = crtc->dev;
413 struct drm_connector *connector;
414 struct drm_encoder *encoder;
415
416 /* Decouple all encoders and their attached connectors from this crtc */
417 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
418 if (encoder->crtc != crtc)
419 continue;
420
421 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
422 if (connector->encoder != encoder)
423 continue;
424
425 connector->encoder = NULL;
426
427 /*
428 * drm_helper_disable_unused_functions() ought to be
429 * doing this, but since we've decoupled the encoder
430 * from the connector above, the required connection
431 * between them is henceforth no longer available.
432 */
433 connector->dpms = DRM_MODE_DPMS_OFF;
434 }
435 }
436
437 __drm_helper_disable_unused_functions(dev);
438 return 0;
439}
440
441/**
442 * drm_crtc_helper_set_config - set a new config from userspace
443 * @set: mode set configuration
444 *
445 * Setup a new configuration, provided by the upper layers (either an ioctl call
446 * from userspace or internally e.g. from the fbdev support code) in @set, and
447 * enable it. This is the main helper functions for drivers that implement
448 * kernel mode setting with the crtc helper functions and the assorted
449 * ->prepare(), ->modeset() and ->commit() helper callbacks.
450 *
451 * Returns:
452 * Returns 0 on success, negative errno numbers on failure.
453 */
454int drm_crtc_helper_set_config(struct drm_mode_set *set)
455{
456 struct drm_device *dev;
457 struct drm_crtc *new_crtc;
458 struct drm_encoder *save_encoders, *new_encoder, *encoder;
459 bool mode_changed = false; /* if true do a full mode set */
460 bool fb_changed = false; /* if true and !mode_changed just do a flip */
461 struct drm_connector *save_connectors, *connector;
462 int count = 0, ro, fail = 0;
463 struct drm_crtc_helper_funcs *crtc_funcs;
464 struct drm_mode_set save_set;
465 int ret;
466 int i;
467
468 DRM_DEBUG_KMS("\n");
469
470 BUG_ON(!set);
471 BUG_ON(!set->crtc);
472 BUG_ON(!set->crtc->helper_private);
473
474 /* Enforce sane interface api - has been abused by the fb helper. */
475 BUG_ON(!set->mode && set->fb);
476 BUG_ON(set->fb && set->num_connectors == 0);
477
478 crtc_funcs = set->crtc->helper_private;
479
480 if (!set->mode)
481 set->fb = NULL;
482
483 if (set->fb) {
484 DRM_DEBUG_KMS("[CRTC:%d] [FB:%d] #connectors=%d (x y) (%i %i)\n",
485 set->crtc->base.id, set->fb->base.id,
486 (int)set->num_connectors, set->x, set->y);
487 } else {
488 DRM_DEBUG_KMS("[CRTC:%d] [NOFB]\n", set->crtc->base.id);
489 return drm_crtc_helper_disable(set->crtc);
490 }
491
492 dev = set->crtc->dev;
493
494 drm_warn_on_modeset_not_all_locked(dev);
495
496 /*
497 * Allocate space for the backup of all (non-pointer) encoder and
498 * connector data.
499 */
500 save_encoders = kzalloc(dev->mode_config.num_encoder *
501 sizeof(struct drm_encoder), GFP_KERNEL);
502 if (!save_encoders)
503 return -ENOMEM;
504
505 save_connectors = kzalloc(dev->mode_config.num_connector *
506 sizeof(struct drm_connector), GFP_KERNEL);
507 if (!save_connectors) {
508 kfree(save_encoders);
509 return -ENOMEM;
510 }
511
512 /*
513 * Copy data. Note that driver private data is not affected.
514 * Should anything bad happen only the expected state is
515 * restored, not the drivers personal bookkeeping.
516 */
517 count = 0;
518 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
519 save_encoders[count++] = *encoder;
520 }
521
522 count = 0;
523 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
524 save_connectors[count++] = *connector;
525 }
526
527 save_set.crtc = set->crtc;
528 save_set.mode = &set->crtc->mode;
529 save_set.x = set->crtc->x;
530 save_set.y = set->crtc->y;
531 save_set.fb = set->crtc->primary->fb;
532
533 /* We should be able to check here if the fb has the same properties
534 * and then just flip_or_move it */
535 if (set->crtc->primary->fb != set->fb) {
536 /* If we have no fb then treat it as a full mode set */
537 if (set->crtc->primary->fb == NULL) {
538 DRM_DEBUG_KMS("crtc has no fb, full mode set\n");
539 mode_changed = true;
540 } else if (set->fb == NULL) {
541 mode_changed = true;
542 } else if (set->fb->pixel_format !=
543 set->crtc->primary->fb->pixel_format) {
544 mode_changed = true;
545 } else
546 fb_changed = true;
547 }
548
549 if (set->x != set->crtc->x || set->y != set->crtc->y)
550 fb_changed = true;
551
552 if (set->mode && !drm_mode_equal(set->mode, &set->crtc->mode)) {
553 DRM_DEBUG_KMS("modes are different, full mode set\n");
554 drm_mode_debug_printmodeline(&set->crtc->mode);
555 drm_mode_debug_printmodeline(set->mode);
556 mode_changed = true;
557 }
558
559 /* a) traverse passed in connector list and get encoders for them */
560 count = 0;
561 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
562 struct drm_connector_helper_funcs *connector_funcs =
563 connector->helper_private;
564 new_encoder = connector->encoder;
565 for (ro = 0; ro < set->num_connectors; ro++) {
566 if (set->connectors[ro] == connector) {
567 new_encoder = connector_funcs->best_encoder(connector);
568 /* if we can't get an encoder for a connector
569 we are setting now - then fail */
570 if (new_encoder == NULL)
571 /* don't break so fail path works correct */
572 fail = 1;
573
574 if (connector->dpms != DRM_MODE_DPMS_ON) {
575 DRM_DEBUG_KMS("connector dpms not on, full mode switch\n");
576 mode_changed = true;
577 }
578
579 break;
580 }
581 }
582
583 if (new_encoder != connector->encoder) {
584 DRM_DEBUG_KMS("encoder changed, full mode switch\n");
585 mode_changed = true;
586 /* If the encoder is reused for another connector, then
587 * the appropriate crtc will be set later.
588 */
589 if (connector->encoder)
590 connector->encoder->crtc = NULL;
591 connector->encoder = new_encoder;
592 }
593 }
594
595 if (fail) {
596 ret = -EINVAL;
597 goto fail;
598 }
599
600 count = 0;
601 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
602 if (!connector->encoder)
603 continue;
604
605 if (connector->encoder->crtc == set->crtc)
606 new_crtc = NULL;
607 else
608 new_crtc = connector->encoder->crtc;
609
610 for (ro = 0; ro < set->num_connectors; ro++) {
611 if (set->connectors[ro] == connector)
612 new_crtc = set->crtc;
613 }
614
615 /* Make sure the new CRTC will work with the encoder */
616 if (new_crtc &&
617 !drm_encoder_crtc_ok(connector->encoder, new_crtc)) {
618 ret = -EINVAL;
619 goto fail;
620 }
621 if (new_crtc != connector->encoder->crtc) {
622 DRM_DEBUG_KMS("crtc changed, full mode switch\n");
623 mode_changed = true;
624 connector->encoder->crtc = new_crtc;
625 }
626 if (new_crtc) {
627 DRM_DEBUG_KMS("[CONNECTOR:%d:%s] to [CRTC:%d]\n",
628 connector->base.id, drm_get_connector_name(connector),
629 new_crtc->base.id);
630 } else {
631 DRM_DEBUG_KMS("[CONNECTOR:%d:%s] to [NOCRTC]\n",
632 connector->base.id, drm_get_connector_name(connector));
633 }
634 }
635
636 /* mode_set_base is not a required function */
637 if (fb_changed && !crtc_funcs->mode_set_base)
638 mode_changed = true;
639
640 if (mode_changed) {
641 if (drm_helper_crtc_in_use(set->crtc)) {
642 DRM_DEBUG_KMS("attempting to set mode from"
643 " userspace\n");
644 drm_mode_debug_printmodeline(set->mode);
645 set->crtc->primary->fb = set->fb;
646 if (!drm_crtc_helper_set_mode(set->crtc, set->mode,
647 set->x, set->y,
648 save_set.fb)) {
649 DRM_ERROR("failed to set mode on [CRTC:%d]\n",
650 set->crtc->base.id);
651 set->crtc->primary->fb = save_set.fb;
652 ret = -EINVAL;
653 goto fail;
654 }
655 DRM_DEBUG_KMS("Setting connector DPMS state to on\n");
656 for (i = 0; i < set->num_connectors; i++) {
657 DRM_DEBUG_KMS("\t[CONNECTOR:%d:%s] set DPMS on\n", set->connectors[i]->base.id,
658 drm_get_connector_name(set->connectors[i]));
659 set->connectors[i]->funcs->dpms(set->connectors[i], DRM_MODE_DPMS_ON);
660 }
661 }
662 __drm_helper_disable_unused_functions(dev);
663 } else if (fb_changed) {
664 set->crtc->x = set->x;
665 set->crtc->y = set->y;
666 set->crtc->primary->fb = set->fb;
667 ret = crtc_funcs->mode_set_base(set->crtc,
668 set->x, set->y, save_set.fb);
669 if (ret != 0) {
670 set->crtc->x = save_set.x;
671 set->crtc->y = save_set.y;
672 set->crtc->primary->fb = save_set.fb;
673 goto fail;
674 }
675 }
676
677 kfree(save_connectors);
678 kfree(save_encoders);
679 return 0;
680
681fail:
682 /* Restore all previous data. */
683 count = 0;
684 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
685 *encoder = save_encoders[count++];
686 }
687
688 count = 0;
689 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
690 *connector = save_connectors[count++];
691 }
692
693 /* Try to restore the config */
694 if (mode_changed &&
695 !drm_crtc_helper_set_mode(save_set.crtc, save_set.mode, save_set.x,
696 save_set.y, save_set.fb))
697 DRM_ERROR("failed to restore config after modeset failure\n");
698
699 kfree(save_connectors);
700 kfree(save_encoders);
701 return ret;
702}
703EXPORT_SYMBOL(drm_crtc_helper_set_config);
704
705static int drm_helper_choose_encoder_dpms(struct drm_encoder *encoder)
706{
707 int dpms = DRM_MODE_DPMS_OFF;
708 struct drm_connector *connector;
709 struct drm_device *dev = encoder->dev;
710
711 list_for_each_entry(connector, &dev->mode_config.connector_list, head)
712 if (connector->encoder == encoder)
713 if (connector->dpms < dpms)
714 dpms = connector->dpms;
715 return dpms;
716}
717
718/* Helper which handles bridge ordering around encoder dpms */
719static void drm_helper_encoder_dpms(struct drm_encoder *encoder, int mode)
720{
721 struct drm_bridge *bridge = encoder->bridge;
722 struct drm_encoder_helper_funcs *encoder_funcs;
723
724 if (bridge) {
725 if (mode == DRM_MODE_DPMS_ON)
726 bridge->funcs->pre_enable(bridge);
727 else
728 bridge->funcs->disable(bridge);
729 }
730
731 encoder_funcs = encoder->helper_private;
732 if (encoder_funcs->dpms)
733 encoder_funcs->dpms(encoder, mode);
734
735 if (bridge) {
736 if (mode == DRM_MODE_DPMS_ON)
737 bridge->funcs->enable(bridge);
738 else
739 bridge->funcs->post_disable(bridge);
740 }
741}
742
743static int drm_helper_choose_crtc_dpms(struct drm_crtc *crtc)
744{
745 int dpms = DRM_MODE_DPMS_OFF;
746 struct drm_connector *connector;
747 struct drm_device *dev = crtc->dev;
748
749 list_for_each_entry(connector, &dev->mode_config.connector_list, head)
750 if (connector->encoder && connector->encoder->crtc == crtc)
751 if (connector->dpms < dpms)
752 dpms = connector->dpms;
753 return dpms;
754}
755
756/**
757 * drm_helper_connector_dpms() - connector dpms helper implementation
758 * @connector: affected connector
759 * @mode: DPMS mode
760 *
761 * This is the main helper function provided by the crtc helper framework for
762 * implementing the DPMS connector attribute. It computes the new desired DPMS
763 * state for all encoders and crtcs in the output mesh and calls the ->dpms()
764 * callback provided by the driver appropriately.
765 */
766void drm_helper_connector_dpms(struct drm_connector *connector, int mode)
767{
768 struct drm_encoder *encoder = connector->encoder;
769 struct drm_crtc *crtc = encoder ? encoder->crtc : NULL;
770 int old_dpms, encoder_dpms = DRM_MODE_DPMS_OFF;
771
772 if (mode == connector->dpms)
773 return;
774
775 old_dpms = connector->dpms;
776 connector->dpms = mode;
777
778 if (encoder)
779 encoder_dpms = drm_helper_choose_encoder_dpms(encoder);
780
781 /* from off to on, do crtc then encoder */
782 if (mode < old_dpms) {
783 if (crtc) {
784 struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
785 if (crtc_funcs->dpms)
786 (*crtc_funcs->dpms) (crtc,
787 drm_helper_choose_crtc_dpms(crtc));
788 }
789 if (encoder)
790 drm_helper_encoder_dpms(encoder, encoder_dpms);
791 }
792
793 /* from on to off, do encoder then crtc */
794 if (mode > old_dpms) {
795 if (encoder)
796 drm_helper_encoder_dpms(encoder, encoder_dpms);
797 if (crtc) {
798 struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
799 if (crtc_funcs->dpms)
800 (*crtc_funcs->dpms) (crtc,
801 drm_helper_choose_crtc_dpms(crtc));
802 }
803 }
804
805 return;
806}
807EXPORT_SYMBOL(drm_helper_connector_dpms);
808
809/**
810 * drm_helper_mode_fill_fb_struct - fill out framebuffer metadata
811 * @fb: drm_framebuffer object to fill out
812 * @mode_cmd: metadata from the userspace fb creation request
813 *
814 * This helper can be used in a drivers fb_create callback to pre-fill the fb's
815 * metadata fields.
816 */
817void drm_helper_mode_fill_fb_struct(struct drm_framebuffer *fb,
818 struct drm_mode_fb_cmd2 *mode_cmd)
819{
820 int i;
821
822 fb->width = mode_cmd->width;
823 fb->height = mode_cmd->height;
824 for (i = 0; i < 4; i++) {
825 fb->pitches[i] = mode_cmd->pitches[i];
826 fb->offsets[i] = mode_cmd->offsets[i];
827 }
828 drm_fb_get_bpp_depth(mode_cmd->pixel_format, &fb->depth,
829 &fb->bits_per_pixel);
830 fb->pixel_format = mode_cmd->pixel_format;
831}
832EXPORT_SYMBOL(drm_helper_mode_fill_fb_struct);
833
834/**
835 * drm_helper_resume_force_mode - force-restore mode setting configuration
836 * @dev: drm_device which should be restored
837 *
838 * Drivers which use the mode setting helpers can use this function to
839 * force-restore the mode setting configuration e.g. on resume or when something
840 * else might have trampled over the hw state (like some overzealous old BIOSen
841 * tended to do).
842 *
843 * This helper doesn't provide a error return value since restoring the old
844 * config should never fail due to resource allocation issues since the driver
845 * has successfully set the restored configuration already. Hence this should
846 * boil down to the equivalent of a few dpms on calls, which also don't provide
847 * an error code.
848 *
849 * Drivers where simply restoring an old configuration again might fail (e.g.
850 * due to slight differences in allocating shared resources when the
851 * configuration is restored in a different order than when userspace set it up)
852 * need to use their own restore logic.
853 */
854void drm_helper_resume_force_mode(struct drm_device *dev)
855{
856 struct drm_crtc *crtc;
857 struct drm_encoder *encoder;
858 struct drm_crtc_helper_funcs *crtc_funcs;
859 int encoder_dpms;
860 bool ret;
861
862 drm_modeset_lock_all(dev);
863 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
864
865 if (!crtc->enabled)
866 continue;
867
868 ret = drm_crtc_helper_set_mode(crtc, &crtc->mode,
869 crtc->x, crtc->y, crtc->primary->fb);
870
871 /* Restoring the old config should never fail! */
872 if (ret == false)
873 DRM_ERROR("failed to set mode on crtc %p\n", crtc);
874
875 /* Turn off outputs that were already powered off */
876 if (drm_helper_choose_crtc_dpms(crtc)) {
877 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
878
879 if(encoder->crtc != crtc)
880 continue;
881
882 encoder_dpms = drm_helper_choose_encoder_dpms(
883 encoder);
884
885 drm_helper_encoder_dpms(encoder, encoder_dpms);
886 }
887
888 crtc_funcs = crtc->helper_private;
889 if (crtc_funcs->dpms)
890 (*crtc_funcs->dpms) (crtc,
891 drm_helper_choose_crtc_dpms(crtc));
892 }
893 }
894
895 /* disable the unused connectors while restoring the modesetting */
896 __drm_helper_disable_unused_functions(dev);
897 drm_modeset_unlock_all(dev);
898}
899EXPORT_SYMBOL(drm_helper_resume_force_mode);
900