2 * Copyright (c) 2006-2008 Intel Corporation
3 * Copyright (c) 2007 Dave Airlie <airlied@linux.ie>
5 * DRM core CRTC related functions
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.
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
27 * Eric Anholt <eric@anholt.net>
28 * Dave Airlie <airlied@linux.ie>
29 * Jesse Barnes <jesse.barnes@intel.com>
34 #include "drm_crtc_helper.h"
37 * Detailed mode info for 800x600@60Hz
39 static struct drm_display_mode std_modes[] = {
40 { DRM_MODE("800x600", DRM_MODE_TYPE_DEFAULT, 40000, 800, 840,
41 968, 1056, 0, 600, 601, 605, 628, 0,
42 DRM_MODE_FLAG_PHSYNC | DRM_MODE_FLAG_PVSYNC) },
45 static void drm_mode_validate_flag(struct drm_connector *connector,
48 struct drm_display_mode *mode, *t;
50 if (flags == (DRM_MODE_FLAG_DBLSCAN | DRM_MODE_FLAG_INTERLACE))
53 list_for_each_entry_safe(mode, t, &connector->modes, head) {
54 if ((mode->flags & DRM_MODE_FLAG_INTERLACE) &&
55 !(flags & DRM_MODE_FLAG_INTERLACE))
56 mode->status = MODE_NO_INTERLACE;
57 if ((mode->flags & DRM_MODE_FLAG_DBLSCAN) &&
58 !(flags & DRM_MODE_FLAG_DBLSCAN))
59 mode->status = MODE_NO_DBLESCAN;
66 * drm_helper_probe_connector_modes - get complete set of display modes
68 * @maxX: max width for modes
69 * @maxY: max height for modes
72 * Caller must hold mode config lock.
74 * Based on @dev's mode_config layout, scan all the connectors and try to detect
75 * modes on them. Modes will first be added to the connector's probed_modes
76 * list, then culled (based on validity and the @maxX, @maxY parameters) and
77 * put into the normal modes list.
79 * Intended to be used either at bootup time or when major configuration
80 * changes have occurred.
82 * FIXME: take into account monitor limits
85 * Number of modes found on @connector.
87 int drm_helper_probe_single_connector_modes(struct drm_connector *connector,
88 uint32_t maxX, uint32_t maxY)
90 struct drm_device *dev = connector->dev;
91 struct drm_display_mode *mode, *t;
92 struct drm_connector_helper_funcs *connector_funcs =
93 connector->helper_private;
97 DRM_DEBUG_KMS("%s\n", drm_get_connector_name(connector));
98 /* set all modes to the unverified state */
99 list_for_each_entry_safe(mode, t, &connector->modes, head)
100 mode->status = MODE_UNVERIFIED;
102 connector->status = connector->funcs->detect(connector);
104 if (connector->status == connector_status_disconnected) {
105 DRM_DEBUG_KMS("%s is disconnected\n",
106 drm_get_connector_name(connector));
107 /* TODO set EDID to NULL */
111 count = (*connector_funcs->get_modes)(connector);
115 drm_mode_connector_list_update(connector);
118 drm_mode_validate_size(dev, &connector->modes, maxX,
121 if (connector->interlace_allowed)
122 mode_flags |= DRM_MODE_FLAG_INTERLACE;
123 if (connector->doublescan_allowed)
124 mode_flags |= DRM_MODE_FLAG_DBLSCAN;
125 drm_mode_validate_flag(connector, mode_flags);
127 list_for_each_entry_safe(mode, t, &connector->modes, head) {
128 if (mode->status == MODE_OK)
129 mode->status = connector_funcs->mode_valid(connector,
134 drm_mode_prune_invalid(dev, &connector->modes, true);
136 if (list_empty(&connector->modes))
139 drm_mode_sort(&connector->modes);
141 DRM_DEBUG_KMS("Probed modes for %s\n",
142 drm_get_connector_name(connector));
143 list_for_each_entry_safe(mode, t, &connector->modes, head) {
144 mode->vrefresh = drm_mode_vrefresh(mode);
146 drm_mode_set_crtcinfo(mode, CRTC_INTERLACE_HALVE_V);
147 drm_mode_debug_printmodeline(mode);
152 EXPORT_SYMBOL(drm_helper_probe_single_connector_modes);
154 int drm_helper_probe_connector_modes(struct drm_device *dev, uint32_t maxX,
157 struct drm_connector *connector;
160 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
161 count += drm_helper_probe_single_connector_modes(connector,
167 EXPORT_SYMBOL(drm_helper_probe_connector_modes);
169 static void drm_helper_add_std_modes(struct drm_device *dev,
170 struct drm_connector *connector)
172 struct drm_display_mode *mode, *t;
175 for (i = 0; i < ARRAY_SIZE(std_modes); i++) {
176 struct drm_display_mode *stdmode;
179 * When no valid EDID modes are available we end up
180 * here and bailed in the past, now we add some standard
183 stdmode = drm_mode_duplicate(dev, &std_modes[i]);
184 drm_mode_probed_add(connector, stdmode);
185 drm_mode_list_concat(&connector->probed_modes,
188 DRM_DEBUG_KMS("Adding mode %s to %s\n", stdmode->name,
189 drm_get_connector_name(connector));
191 drm_mode_sort(&connector->modes);
193 DRM_DEBUG_KMS("Added std modes on %s\n",
194 drm_get_connector_name(connector));
195 list_for_each_entry_safe(mode, t, &connector->modes, head) {
196 mode->vrefresh = drm_mode_vrefresh(mode);
198 drm_mode_set_crtcinfo(mode, CRTC_INTERLACE_HALVE_V);
199 drm_mode_debug_printmodeline(mode);
204 * drm_helper_encoder_in_use - check if a given encoder is in use
205 * @encoder: encoder to check
208 * Caller must hold mode config lock.
210 * Walk @encoders's DRM device's mode_config and see if it's in use.
213 * True if @encoder is part of the mode_config, false otherwise.
215 bool drm_helper_encoder_in_use(struct drm_encoder *encoder)
217 struct drm_connector *connector;
218 struct drm_device *dev = encoder->dev;
219 list_for_each_entry(connector, &dev->mode_config.connector_list, head)
220 if (connector->encoder == encoder)
224 EXPORT_SYMBOL(drm_helper_encoder_in_use);
227 * drm_helper_crtc_in_use - check if a given CRTC is in a mode_config
228 * @crtc: CRTC to check
231 * Caller must hold mode config lock.
233 * Walk @crtc's DRM device's mode_config and see if it's in use.
236 * True if @crtc is part of the mode_config, false otherwise.
238 bool drm_helper_crtc_in_use(struct drm_crtc *crtc)
240 struct drm_encoder *encoder;
241 struct drm_device *dev = crtc->dev;
242 /* FIXME: Locking around list access? */
243 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head)
244 if (encoder->crtc == crtc && drm_helper_encoder_in_use(encoder))
248 EXPORT_SYMBOL(drm_helper_crtc_in_use);
251 * drm_disable_unused_functions - disable unused objects
255 * Caller must hold mode config lock.
257 * If an connector or CRTC isn't part of @dev's mode_config, it can be disabled
258 * by calling its dpms function, which should power it off.
260 void drm_helper_disable_unused_functions(struct drm_device *dev)
262 struct drm_encoder *encoder;
263 struct drm_connector *connector;
264 struct drm_encoder_helper_funcs *encoder_funcs;
265 struct drm_crtc *crtc;
267 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
268 if (!connector->encoder)
270 if (connector->status == connector_status_disconnected)
271 connector->encoder = NULL;
274 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
275 encoder_funcs = encoder->helper_private;
276 if (!drm_helper_encoder_in_use(encoder)) {
277 if (encoder_funcs->disable)
278 (*encoder_funcs->disable)(encoder);
280 (*encoder_funcs->dpms)(encoder, DRM_MODE_DPMS_OFF);
281 /* disconnector encoder from any connector */
282 encoder->crtc = NULL;
286 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
287 struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
288 crtc->enabled = drm_helper_crtc_in_use(crtc);
289 if (!crtc->enabled) {
290 crtc_funcs->dpms(crtc, DRM_MODE_DPMS_OFF);
295 EXPORT_SYMBOL(drm_helper_disable_unused_functions);
297 static struct drm_display_mode *drm_has_preferred_mode(struct drm_connector *connector, int width, int height)
299 struct drm_display_mode *mode;
301 list_for_each_entry(mode, &connector->modes, head) {
302 if (drm_mode_width(mode) > width ||
303 drm_mode_height(mode) > height)
305 if (mode->type & DRM_MODE_TYPE_PREFERRED)
311 static bool drm_connector_enabled(struct drm_connector *connector, bool strict)
316 enable = connector->status == connector_status_connected;
318 enable = connector->status != connector_status_disconnected;
323 static void drm_enable_connectors(struct drm_device *dev, bool *enabled)
325 bool any_enabled = false;
326 struct drm_connector *connector;
329 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
330 enabled[i] = drm_connector_enabled(connector, true);
331 DRM_DEBUG_KMS("connector %d enabled? %s\n", connector->base.id,
332 enabled[i] ? "yes" : "no");
333 any_enabled |= enabled[i];
341 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
342 enabled[i] = drm_connector_enabled(connector, false);
347 static bool drm_target_preferred(struct drm_device *dev,
348 struct drm_display_mode **modes,
349 bool *enabled, int width, int height)
351 struct drm_connector *connector;
354 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
356 if (enabled[i] == false) {
361 DRM_DEBUG_KMS("looking for preferred mode on connector %d\n",
364 modes[i] = drm_has_preferred_mode(connector, width, height);
365 /* No preferred modes, pick one off the list */
366 if (!modes[i] && !list_empty(&connector->modes)) {
367 list_for_each_entry(modes[i], &connector->modes, head)
370 DRM_DEBUG_KMS("found mode %s\n", modes[i] ? modes[i]->name :
377 static int drm_pick_crtcs(struct drm_device *dev,
378 struct drm_crtc **best_crtcs,
379 struct drm_display_mode **modes,
380 int n, int width, int height)
383 struct drm_connector *connector;
384 struct drm_connector_helper_funcs *connector_funcs;
385 struct drm_encoder *encoder;
386 struct drm_crtc *best_crtc;
387 int my_score, best_score, score;
388 struct drm_crtc **crtcs, *crtc;
390 if (n == dev->mode_config.num_connector)
393 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
399 best_crtcs[n] = NULL;
401 best_score = drm_pick_crtcs(dev, best_crtcs, modes, n+1, width, height);
402 if (modes[n] == NULL)
405 crtcs = kmalloc(dev->mode_config.num_connector *
406 sizeof(struct drm_crtc *), GFP_KERNEL);
411 if (connector->status == connector_status_connected)
413 if (drm_has_preferred_mode(connector, width, height))
416 connector_funcs = connector->helper_private;
417 encoder = connector_funcs->best_encoder(connector);
421 connector->encoder = encoder;
423 /* select a crtc for this connector and then attempt to configure
424 remaining connectors */
426 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
428 if ((encoder->possible_crtcs & (1 << c)) == 0) {
433 for (o = 0; o < n; o++)
434 if (best_crtcs[o] == crtc)
438 /* ignore cloning for now */
444 memcpy(crtcs, best_crtcs, n * sizeof(struct drm_crtc *));
445 score = my_score + drm_pick_crtcs(dev, crtcs, modes, n + 1,
447 if (score > best_score) {
450 memcpy(best_crtcs, crtcs,
451 dev->mode_config.num_connector *
452 sizeof(struct drm_crtc *));
461 static void drm_setup_crtcs(struct drm_device *dev)
463 struct drm_crtc **crtcs;
464 struct drm_display_mode **modes;
465 struct drm_encoder *encoder;
466 struct drm_connector *connector;
473 width = dev->mode_config.max_width;
474 height = dev->mode_config.max_height;
476 /* clean out all the encoder/crtc combos */
477 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
478 encoder->crtc = NULL;
481 crtcs = kcalloc(dev->mode_config.num_connector,
482 sizeof(struct drm_crtc *), GFP_KERNEL);
483 modes = kcalloc(dev->mode_config.num_connector,
484 sizeof(struct drm_display_mode *), GFP_KERNEL);
485 enabled = kcalloc(dev->mode_config.num_connector,
486 sizeof(bool), GFP_KERNEL);
488 drm_enable_connectors(dev, enabled);
490 ret = drm_target_preferred(dev, modes, enabled, width, height);
492 DRM_ERROR("Unable to find initial modes\n");
494 DRM_DEBUG_KMS("picking CRTCs for %dx%d config\n", width, height);
496 drm_pick_crtcs(dev, crtcs, modes, 0, width, height);
499 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
500 struct drm_display_mode *mode = modes[i];
501 struct drm_crtc *crtc = crtcs[i];
503 if (connector->encoder == NULL) {
509 DRM_DEBUG_KMS("desired mode %s set on crtc %d\n",
510 mode->name, crtc->base.id);
511 crtc->desired_mode = mode;
512 connector->encoder->crtc = crtc;
514 connector->encoder->crtc = NULL;
515 connector->encoder = NULL;
526 * drm_encoder_crtc_ok - can a given crtc drive a given encoder?
527 * @encoder: encoder to test
528 * @crtc: crtc to test
530 * Return false if @encoder can't be driven by @crtc, true otherwise.
532 static bool drm_encoder_crtc_ok(struct drm_encoder *encoder,
533 struct drm_crtc *crtc)
535 struct drm_device *dev;
536 struct drm_crtc *tmp;
539 WARN(!crtc, "checking null crtc?");
543 list_for_each_entry(tmp, &dev->mode_config.crtc_list, head) {
549 if (encoder->possible_crtcs & crtc_mask)
555 * Check the CRTC we're going to map each output to vs. its current
556 * CRTC. If they don't match, we have to disable the output and the CRTC
557 * since the driver will have to re-route things.
560 drm_crtc_prepare_encoders(struct drm_device *dev)
562 struct drm_encoder_helper_funcs *encoder_funcs;
563 struct drm_encoder *encoder;
565 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
566 encoder_funcs = encoder->helper_private;
567 /* Disable unused encoders */
568 if (encoder->crtc == NULL)
569 (*encoder_funcs->dpms)(encoder, DRM_MODE_DPMS_OFF);
570 /* Disable encoders whose CRTC is about to change */
571 if (encoder_funcs->get_crtc &&
572 encoder->crtc != (*encoder_funcs->get_crtc)(encoder))
573 (*encoder_funcs->dpms)(encoder, DRM_MODE_DPMS_OFF);
578 * drm_crtc_set_mode - set a mode
579 * @crtc: CRTC to program
585 * Caller must hold mode config lock.
587 * Try to set @mode on @crtc. Give @crtc and its associated connectors a chance
588 * to fixup or reject the mode prior to trying to set it.
591 * True if the mode was set successfully, or false otherwise.
593 bool drm_crtc_helper_set_mode(struct drm_crtc *crtc,
594 struct drm_display_mode *mode,
596 struct drm_framebuffer *old_fb)
598 struct drm_device *dev = crtc->dev;
599 struct drm_display_mode *adjusted_mode, saved_mode;
600 struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
601 struct drm_encoder_helper_funcs *encoder_funcs;
602 int saved_x, saved_y;
603 struct drm_encoder *encoder;
606 adjusted_mode = drm_mode_duplicate(dev, mode);
608 crtc->enabled = drm_helper_crtc_in_use(crtc);
613 saved_mode = crtc->mode;
617 /* Update crtc values up front so the driver can rely on them for mode
624 /* Pass our mode to the connectors and the CRTC to give them a chance to
625 * adjust it according to limitations or connector properties, and also
626 * a chance to reject the mode entirely.
628 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
630 if (encoder->crtc != crtc)
632 encoder_funcs = encoder->helper_private;
633 if (!(ret = encoder_funcs->mode_fixup(encoder, mode,
639 if (!(ret = crtc_funcs->mode_fixup(crtc, mode, adjusted_mode))) {
643 /* Prepare the encoders and CRTCs before setting the mode. */
644 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
646 if (encoder->crtc != crtc)
648 encoder_funcs = encoder->helper_private;
649 /* Disable the encoders as the first thing we do. */
650 encoder_funcs->prepare(encoder);
653 drm_crtc_prepare_encoders(dev);
655 crtc_funcs->prepare(crtc);
657 /* Set up the DPLL and any encoders state that needs to adjust or depend
660 ret = !crtc_funcs->mode_set(crtc, mode, adjusted_mode, x, y, old_fb);
664 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
666 if (encoder->crtc != crtc)
669 DRM_INFO("%s: set mode %s %x\n", drm_get_encoder_name(encoder),
670 mode->name, mode->base.id);
671 encoder_funcs = encoder->helper_private;
672 encoder_funcs->mode_set(encoder, mode, adjusted_mode);
675 /* Now enable the clocks, plane, pipe, and connectors that we set up. */
676 crtc_funcs->commit(crtc);
678 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
680 if (encoder->crtc != crtc)
683 encoder_funcs = encoder->helper_private;
684 encoder_funcs->commit(encoder);
688 /* XXX free adjustedmode */
689 drm_mode_destroy(dev, adjusted_mode);
690 /* FIXME: add subpixel order */
693 crtc->mode = saved_mode;
700 EXPORT_SYMBOL(drm_crtc_helper_set_mode);
704 * drm_crtc_helper_set_config - set a new config from userspace
705 * @crtc: CRTC to setup
706 * @crtc_info: user provided configuration
707 * @new_mode: new mode to set
708 * @connector_set: set of connectors for the new config
709 * @fb: new framebuffer
712 * Caller must hold mode config lock.
714 * Setup a new configuration, provided by the user in @crtc_info, and enable
720 int drm_crtc_helper_set_config(struct drm_mode_set *set)
722 struct drm_device *dev;
723 struct drm_crtc *save_crtcs, *new_crtc, *crtc;
724 struct drm_encoder *save_encoders, *new_encoder, *encoder;
725 struct drm_framebuffer *old_fb = NULL;
726 bool mode_changed = false; /* if true do a full mode set */
727 bool fb_changed = false; /* if true and !mode_changed just do a flip */
728 struct drm_connector *save_connectors, *connector;
729 int count = 0, ro, fail = 0;
730 struct drm_crtc_helper_funcs *crtc_funcs;
741 if (!set->crtc->helper_private)
744 crtc_funcs = set->crtc->helper_private;
746 DRM_DEBUG_KMS("crtc: %p %d fb: %p connectors: %p num_connectors:"
747 " %d (x, y) (%i, %i)\n",
748 set->crtc, set->crtc->base.id, set->fb, set->connectors,
749 (int)set->num_connectors, set->x, set->y);
751 dev = set->crtc->dev;
753 /* Allocate space for the backup of all (non-pointer) crtc, encoder and
755 save_crtcs = kzalloc(dev->mode_config.num_crtc *
756 sizeof(struct drm_crtc), GFP_KERNEL);
760 save_encoders = kzalloc(dev->mode_config.num_encoder *
761 sizeof(struct drm_encoder), GFP_KERNEL);
762 if (!save_encoders) {
767 save_connectors = kzalloc(dev->mode_config.num_connector *
768 sizeof(struct drm_connector), GFP_KERNEL);
769 if (!save_connectors) {
771 kfree(save_encoders);
775 /* Copy data. Note that driver private data is not affected.
776 * Should anything bad happen only the expected state is
777 * restored, not the drivers personal bookkeeping.
780 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
781 save_crtcs[count++] = *crtc;
785 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
786 save_encoders[count++] = *encoder;
790 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
791 save_connectors[count++] = *connector;
794 /* We should be able to check here if the fb has the same properties
795 * and then just flip_or_move it */
796 if (set->crtc->fb != set->fb) {
797 /* If we have no fb then treat it as a full mode set */
798 if (set->crtc->fb == NULL) {
799 DRM_DEBUG_KMS("crtc has no fb, full mode set\n");
801 } else if (set->fb == NULL) {
803 } else if ((set->fb->bits_per_pixel !=
804 set->crtc->fb->bits_per_pixel) ||
805 set->fb->depth != set->crtc->fb->depth)
811 if (set->x != set->crtc->x || set->y != set->crtc->y)
814 if (set->mode && !drm_mode_equal(set->mode, &set->crtc->mode)) {
815 DRM_DEBUG_KMS("modes are different, full mode set\n");
816 drm_mode_debug_printmodeline(&set->crtc->mode);
817 drm_mode_debug_printmodeline(set->mode);
821 /* a) traverse passed in connector list and get encoders for them */
823 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
824 struct drm_connector_helper_funcs *connector_funcs =
825 connector->helper_private;
826 new_encoder = connector->encoder;
827 for (ro = 0; ro < set->num_connectors; ro++) {
828 if (set->connectors[ro] == connector) {
829 new_encoder = connector_funcs->best_encoder(connector);
830 /* if we can't get an encoder for a connector
831 we are setting now - then fail */
832 if (new_encoder == NULL)
833 /* don't break so fail path works correct */
839 if (new_encoder != connector->encoder) {
840 DRM_DEBUG_KMS("encoder changed, full mode switch\n");
842 /* If the encoder is reused for another connector, then
843 * the appropriate crtc will be set later.
845 connector->encoder->crtc = NULL;
846 connector->encoder = new_encoder;
856 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
857 if (!connector->encoder)
860 if (connector->encoder->crtc == set->crtc)
863 new_crtc = connector->encoder->crtc;
865 for (ro = 0; ro < set->num_connectors; ro++) {
866 if (set->connectors[ro] == connector)
867 new_crtc = set->crtc;
870 /* Make sure the new CRTC will work with the encoder */
872 !drm_encoder_crtc_ok(connector->encoder, new_crtc)) {
876 if (new_crtc != connector->encoder->crtc) {
877 DRM_DEBUG_KMS("crtc changed, full mode switch\n");
879 connector->encoder->crtc = new_crtc;
881 DRM_DEBUG_KMS("setting connector %d crtc to %p\n",
882 connector->base.id, new_crtc);
885 /* mode_set_base is not a required function */
886 if (fb_changed && !crtc_funcs->mode_set_base)
890 old_fb = set->crtc->fb;
891 set->crtc->fb = set->fb;
892 set->crtc->enabled = (set->mode != NULL);
893 if (set->mode != NULL) {
894 DRM_DEBUG_KMS("attempting to set mode from"
896 drm_mode_debug_printmodeline(set->mode);
897 if (!drm_crtc_helper_set_mode(set->crtc, set->mode,
900 DRM_ERROR("failed to set mode on crtc %p\n",
905 /* TODO are these needed? */
906 set->crtc->desired_x = set->x;
907 set->crtc->desired_y = set->y;
908 set->crtc->desired_mode = set->mode;
910 drm_helper_disable_unused_functions(dev);
911 } else if (fb_changed) {
912 old_fb = set->crtc->fb;
913 if (set->crtc->fb != set->fb)
914 set->crtc->fb = set->fb;
915 ret = crtc_funcs->mode_set_base(set->crtc,
916 set->x, set->y, old_fb);
921 kfree(save_connectors);
922 kfree(save_encoders);
927 /* Restore all previous data. */
929 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
930 *crtc = save_crtcs[count++];
934 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
935 *encoder = save_encoders[count++];
939 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
940 *connector = save_connectors[count++];
943 kfree(save_connectors);
944 kfree(save_encoders);
948 EXPORT_SYMBOL(drm_crtc_helper_set_config);
950 bool drm_helper_plugged_event(struct drm_device *dev)
954 drm_helper_probe_connector_modes(dev, dev->mode_config.max_width,
955 dev->mode_config.max_height);
957 drm_setup_crtcs(dev);
959 /* alert the driver fb layer */
960 dev->mode_config.funcs->fb_changed(dev);
962 /* FIXME: send hotplug event */
966 * drm_initial_config - setup a sane initial connector configuration
970 * Called at init time, must take mode config lock.
972 * Scan the CRTCs and connectors and try to put together an initial setup.
973 * At the moment, this is a cloned configuration across all heads with
974 * a new framebuffer object as the backing store.
977 * Zero if everything went ok, nonzero otherwise.
979 bool drm_helper_initial_config(struct drm_device *dev)
981 struct drm_connector *connector;
984 count = drm_helper_probe_connector_modes(dev,
985 dev->mode_config.max_width,
986 dev->mode_config.max_height);
989 * None of the available connectors had any modes, so add some
990 * and try to light them up anyway
993 DRM_ERROR("connectors have no modes, using standard modes\n");
994 list_for_each_entry(connector,
995 &dev->mode_config.connector_list,
997 drm_helper_add_std_modes(dev, connector);
1000 drm_setup_crtcs(dev);
1002 /* alert the driver fb layer */
1003 dev->mode_config.funcs->fb_changed(dev);
1007 EXPORT_SYMBOL(drm_helper_initial_config);
1009 static int drm_helper_choose_encoder_dpms(struct drm_encoder *encoder)
1011 int dpms = DRM_MODE_DPMS_OFF;
1012 struct drm_connector *connector;
1013 struct drm_device *dev = encoder->dev;
1015 list_for_each_entry(connector, &dev->mode_config.connector_list, head)
1016 if (connector->encoder == encoder)
1017 if (connector->dpms < dpms)
1018 dpms = connector->dpms;
1022 static int drm_helper_choose_crtc_dpms(struct drm_crtc *crtc)
1024 int dpms = DRM_MODE_DPMS_OFF;
1025 struct drm_connector *connector;
1026 struct drm_device *dev = crtc->dev;
1028 list_for_each_entry(connector, &dev->mode_config.connector_list, head)
1029 if (connector->encoder && connector->encoder->crtc == crtc)
1030 if (connector->dpms < dpms)
1031 dpms = connector->dpms;
1036 * drm_helper_connector_dpms
1037 * @connector affected connector
1040 * Calls the low-level connector DPMS function, then
1041 * calls appropriate encoder and crtc DPMS functions as well
1043 void drm_helper_connector_dpms(struct drm_connector *connector, int mode)
1045 struct drm_encoder *encoder = connector->encoder;
1046 struct drm_crtc *crtc = encoder ? encoder->crtc : NULL;
1049 if (mode == connector->dpms)
1052 old_dpms = connector->dpms;
1053 connector->dpms = mode;
1055 /* from off to on, do crtc then encoder */
1056 if (mode < old_dpms) {
1058 struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
1059 if (crtc_funcs->dpms)
1060 (*crtc_funcs->dpms) (crtc,
1061 drm_helper_choose_crtc_dpms(crtc));
1064 struct drm_encoder_helper_funcs *encoder_funcs = encoder->helper_private;
1065 if (encoder_funcs->dpms)
1066 (*encoder_funcs->dpms) (encoder,
1067 drm_helper_choose_encoder_dpms(encoder));
1071 /* from on to off, do encoder then crtc */
1072 if (mode > old_dpms) {
1074 struct drm_encoder_helper_funcs *encoder_funcs = encoder->helper_private;
1075 if (encoder_funcs->dpms)
1076 (*encoder_funcs->dpms) (encoder,
1077 drm_helper_choose_encoder_dpms(encoder));
1080 struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
1081 if (crtc_funcs->dpms)
1082 (*crtc_funcs->dpms) (crtc,
1083 drm_helper_choose_crtc_dpms(crtc));
1089 EXPORT_SYMBOL(drm_helper_connector_dpms);
1092 * drm_hotplug_stage_two
1094 * @connector hotpluged connector
1097 * Caller must hold mode config lock, function might grab struct lock.
1099 * Stage two of a hotplug.
1102 * Zero on success, errno on failure.
1104 int drm_helper_hotplug_stage_two(struct drm_device *dev)
1106 drm_helper_plugged_event(dev);
1110 EXPORT_SYMBOL(drm_helper_hotplug_stage_two);
1112 int drm_helper_mode_fill_fb_struct(struct drm_framebuffer *fb,
1113 struct drm_mode_fb_cmd *mode_cmd)
1115 fb->width = mode_cmd->width;
1116 fb->height = mode_cmd->height;
1117 fb->pitch = mode_cmd->pitch;
1118 fb->bits_per_pixel = mode_cmd->bpp;
1119 fb->depth = mode_cmd->depth;
1123 EXPORT_SYMBOL(drm_helper_mode_fill_fb_struct);
1125 int drm_helper_resume_force_mode(struct drm_device *dev)
1127 struct drm_crtc *crtc;
1130 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
1135 ret = drm_crtc_helper_set_mode(crtc, &crtc->mode,
1136 crtc->x, crtc->y, crtc->fb);
1139 DRM_ERROR("failed to set mode on crtc %p\n", crtc);
1141 /* disable the unused connectors while restoring the modesetting */
1142 drm_helper_disable_unused_functions(dev);
1145 EXPORT_SYMBOL(drm_helper_resume_force_mode);