2 * Copyright (c) 2006-2009 Red Hat Inc.
3 * Copyright (c) 2006-2008 Intel Corporation
4 * Copyright (c) 2007 Dave Airlie <airlied@linux.ie>
6 * DRM framebuffer helper functions
8 * Permission to use, copy, modify, distribute, and sell this software and its
9 * documentation for any purpose is hereby granted without fee, provided that
10 * the above copyright notice appear in all copies and that both that copyright
11 * notice and this permission notice appear in supporting documentation, and
12 * that the name of the copyright holders not be used in advertising or
13 * publicity pertaining to distribution of the software without specific,
14 * written prior permission. The copyright holders make no representations
15 * about the suitability of this software for any purpose. It is provided "as
16 * is" without express or implied warranty.
18 * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
19 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
20 * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
21 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
22 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
23 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
27 * Dave Airlie <airlied@linux.ie>
28 * Jesse Barnes <jesse.barnes@intel.com>
30 #include <linux/kernel.h>
31 #include <linux/sysrq.h>
32 #include <linux/slab.h>
34 #include <linux/module.h>
37 #include "drm_fb_helper.h"
38 #include "drm_crtc_helper.h"
40 MODULE_AUTHOR("David Airlie, Jesse Barnes");
41 MODULE_DESCRIPTION("DRM KMS helper");
42 MODULE_LICENSE("GPL and additional rights");
44 static LIST_HEAD(kernel_fb_helper_list);
46 /* simple single crtc case helper function */
47 int drm_fb_helper_single_add_all_connectors(struct drm_fb_helper *fb_helper)
49 struct drm_device *dev = fb_helper->dev;
50 struct drm_connector *connector;
53 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
54 struct drm_fb_helper_connector *fb_helper_connector;
56 fb_helper_connector = kzalloc(sizeof(struct drm_fb_helper_connector), GFP_KERNEL);
57 if (!fb_helper_connector)
60 fb_helper_connector->connector = connector;
61 fb_helper->connector_info[fb_helper->connector_count++] = fb_helper_connector;
65 for (i = 0; i < fb_helper->connector_count; i++) {
66 kfree(fb_helper->connector_info[i]);
67 fb_helper->connector_info[i] = NULL;
69 fb_helper->connector_count = 0;
72 EXPORT_SYMBOL(drm_fb_helper_single_add_all_connectors);
74 static int drm_fb_helper_parse_command_line(struct drm_fb_helper *fb_helper)
76 struct drm_fb_helper_connector *fb_helper_conn;
79 for (i = 0; i < fb_helper->connector_count; i++) {
80 struct drm_cmdline_mode *mode;
81 struct drm_connector *connector;
84 fb_helper_conn = fb_helper->connector_info[i];
85 connector = fb_helper_conn->connector;
86 mode = &fb_helper_conn->cmdline_mode;
88 /* do something on return - turn off connector maybe */
89 if (fb_get_options(drm_get_connector_name(connector), &option))
92 if (drm_mode_parse_command_line_for_connector(option,
97 switch (mode->force) {
98 case DRM_FORCE_OFF: s = "OFF"; break;
99 case DRM_FORCE_ON_DIGITAL: s = "ON - dig"; break;
101 case DRM_FORCE_ON: s = "ON"; break;
104 DRM_INFO("forcing %s connector %s\n",
105 drm_get_connector_name(connector), s);
106 connector->force = mode->force;
109 DRM_DEBUG_KMS("cmdline mode for connector %s %dx%d@%dHz%s%s%s\n",
110 drm_get_connector_name(connector),
111 mode->xres, mode->yres,
112 mode->refresh_specified ? mode->refresh : 60,
113 mode->rb ? " reduced blanking" : "",
114 mode->margins ? " with margins" : "",
115 mode->interlace ? " interlaced" : "");
122 static void drm_fb_helper_save_lut_atomic(struct drm_crtc *crtc, struct drm_fb_helper *helper)
124 uint16_t *r_base, *g_base, *b_base;
127 r_base = crtc->gamma_store;
128 g_base = r_base + crtc->gamma_size;
129 b_base = g_base + crtc->gamma_size;
131 for (i = 0; i < crtc->gamma_size; i++)
132 helper->funcs->gamma_get(crtc, &r_base[i], &g_base[i], &b_base[i], i);
135 static void drm_fb_helper_restore_lut_atomic(struct drm_crtc *crtc)
137 uint16_t *r_base, *g_base, *b_base;
139 r_base = crtc->gamma_store;
140 g_base = r_base + crtc->gamma_size;
141 b_base = g_base + crtc->gamma_size;
143 crtc->funcs->gamma_set(crtc, r_base, g_base, b_base, 0, crtc->gamma_size);
146 int drm_fb_helper_debug_enter(struct fb_info *info)
148 struct drm_fb_helper *helper = info->par;
149 struct drm_crtc_helper_funcs *funcs;
152 if (list_empty(&kernel_fb_helper_list))
155 list_for_each_entry(helper, &kernel_fb_helper_list, kernel_fb_list) {
156 for (i = 0; i < helper->crtc_count; i++) {
157 struct drm_mode_set *mode_set =
158 &helper->crtc_info[i].mode_set;
160 if (!mode_set->crtc->enabled)
163 funcs = mode_set->crtc->helper_private;
164 drm_fb_helper_save_lut_atomic(mode_set->crtc, helper);
165 funcs->mode_set_base_atomic(mode_set->crtc,
169 ENTER_ATOMIC_MODE_SET);
175 EXPORT_SYMBOL(drm_fb_helper_debug_enter);
177 /* Find the real fb for a given fb helper CRTC */
178 static struct drm_framebuffer *drm_mode_config_fb(struct drm_crtc *crtc)
180 struct drm_device *dev = crtc->dev;
183 list_for_each_entry(c, &dev->mode_config.crtc_list, head) {
184 if (crtc->base.id == c->base.id)
191 int drm_fb_helper_debug_leave(struct fb_info *info)
193 struct drm_fb_helper *helper = info->par;
194 struct drm_crtc *crtc;
195 struct drm_crtc_helper_funcs *funcs;
196 struct drm_framebuffer *fb;
199 for (i = 0; i < helper->crtc_count; i++) {
200 struct drm_mode_set *mode_set = &helper->crtc_info[i].mode_set;
201 crtc = mode_set->crtc;
202 funcs = crtc->helper_private;
203 fb = drm_mode_config_fb(crtc);
209 DRM_ERROR("no fb to restore??\n");
213 drm_fb_helper_restore_lut_atomic(mode_set->crtc);
214 funcs->mode_set_base_atomic(mode_set->crtc, fb, crtc->x,
215 crtc->y, LEAVE_ATOMIC_MODE_SET);
220 EXPORT_SYMBOL(drm_fb_helper_debug_leave);
222 bool drm_fb_helper_restore_fbdev_mode(struct drm_fb_helper *fb_helper)
226 for (i = 0; i < fb_helper->crtc_count; i++) {
227 struct drm_mode_set *mode_set = &fb_helper->crtc_info[i].mode_set;
228 struct drm_crtc *crtc = mode_set->crtc;
233 ret = drm_crtc_helper_set_config(mode_set);
239 EXPORT_SYMBOL(drm_fb_helper_restore_fbdev_mode);
241 bool drm_fb_helper_force_kernel_mode(void)
243 bool ret, error = false;
244 struct drm_fb_helper *helper;
246 if (list_empty(&kernel_fb_helper_list))
249 list_for_each_entry(helper, &kernel_fb_helper_list, kernel_fb_list) {
250 if (helper->dev->switch_power_state == DRM_SWITCH_POWER_OFF)
253 ret = drm_fb_helper_restore_fbdev_mode(helper);
260 int drm_fb_helper_panic(struct notifier_block *n, unsigned long ununsed,
264 * It's a waste of time and effort to switch back to text console
265 * if the kernel should reboot before panic messages can be seen.
267 if (panic_timeout < 0)
270 printk(KERN_ERR "panic occurred, switching back to text console\n");
271 return drm_fb_helper_force_kernel_mode();
273 EXPORT_SYMBOL(drm_fb_helper_panic);
275 static struct notifier_block paniced = {
276 .notifier_call = drm_fb_helper_panic,
280 * drm_fb_helper_restore - restore the framebuffer console (kernel) config
282 * Restore's the kernel's fbcon mode, used for lastclose & panic paths.
284 void drm_fb_helper_restore(void)
287 ret = drm_fb_helper_force_kernel_mode();
289 DRM_ERROR("Failed to restore crtc configuration\n");
291 EXPORT_SYMBOL(drm_fb_helper_restore);
293 #ifdef CONFIG_MAGIC_SYSRQ
294 static void drm_fb_helper_restore_work_fn(struct work_struct *ignored)
296 drm_fb_helper_restore();
298 static DECLARE_WORK(drm_fb_helper_restore_work, drm_fb_helper_restore_work_fn);
300 static void drm_fb_helper_sysrq(int dummy1)
302 schedule_work(&drm_fb_helper_restore_work);
305 static struct sysrq_key_op sysrq_drm_fb_helper_restore_op = {
306 .handler = drm_fb_helper_sysrq,
307 .help_msg = "force-fb(V)",
308 .action_msg = "Restore framebuffer console",
311 static struct sysrq_key_op sysrq_drm_fb_helper_restore_op = { };
314 static void drm_fb_helper_dpms(struct fb_info *info, int dpms_mode)
316 struct drm_fb_helper *fb_helper = info->par;
317 struct drm_device *dev = fb_helper->dev;
318 struct drm_crtc *crtc;
319 struct drm_connector *connector;
323 * For each CRTC in this fb, turn the connectors on/off.
325 mutex_lock(&dev->mode_config.mutex);
326 for (i = 0; i < fb_helper->crtc_count; i++) {
327 crtc = fb_helper->crtc_info[i].mode_set.crtc;
332 /* Walk the connectors & encoders on this fb turning them on/off */
333 for (j = 0; j < fb_helper->connector_count; j++) {
334 connector = fb_helper->connector_info[j]->connector;
335 drm_helper_connector_dpms(connector, dpms_mode);
336 drm_connector_property_set_value(connector,
337 dev->mode_config.dpms_property, dpms_mode);
340 mutex_unlock(&dev->mode_config.mutex);
343 int drm_fb_helper_blank(int blank, struct fb_info *info)
346 /* Display: On; HSync: On, VSync: On */
347 case FB_BLANK_UNBLANK:
348 drm_fb_helper_dpms(info, DRM_MODE_DPMS_ON);
350 /* Display: Off; HSync: On, VSync: On */
351 case FB_BLANK_NORMAL:
352 drm_fb_helper_dpms(info, DRM_MODE_DPMS_STANDBY);
354 /* Display: Off; HSync: Off, VSync: On */
355 case FB_BLANK_HSYNC_SUSPEND:
356 drm_fb_helper_dpms(info, DRM_MODE_DPMS_STANDBY);
358 /* Display: Off; HSync: On, VSync: Off */
359 case FB_BLANK_VSYNC_SUSPEND:
360 drm_fb_helper_dpms(info, DRM_MODE_DPMS_SUSPEND);
362 /* Display: Off; HSync: Off, VSync: Off */
363 case FB_BLANK_POWERDOWN:
364 drm_fb_helper_dpms(info, DRM_MODE_DPMS_OFF);
369 EXPORT_SYMBOL(drm_fb_helper_blank);
371 static void drm_fb_helper_crtc_free(struct drm_fb_helper *helper)
375 for (i = 0; i < helper->connector_count; i++)
376 kfree(helper->connector_info[i]);
377 kfree(helper->connector_info);
378 for (i = 0; i < helper->crtc_count; i++) {
379 kfree(helper->crtc_info[i].mode_set.connectors);
380 if (helper->crtc_info[i].mode_set.mode)
381 drm_mode_destroy(helper->dev, helper->crtc_info[i].mode_set.mode);
383 kfree(helper->crtc_info);
386 int drm_fb_helper_init(struct drm_device *dev,
387 struct drm_fb_helper *fb_helper,
388 int crtc_count, int max_conn_count)
390 struct drm_crtc *crtc;
394 fb_helper->dev = dev;
396 INIT_LIST_HEAD(&fb_helper->kernel_fb_list);
398 fb_helper->crtc_info = kcalloc(crtc_count, sizeof(struct drm_fb_helper_crtc), GFP_KERNEL);
399 if (!fb_helper->crtc_info)
402 fb_helper->crtc_count = crtc_count;
403 fb_helper->connector_info = kcalloc(dev->mode_config.num_connector, sizeof(struct drm_fb_helper_connector *), GFP_KERNEL);
404 if (!fb_helper->connector_info) {
405 kfree(fb_helper->crtc_info);
408 fb_helper->connector_count = 0;
410 for (i = 0; i < crtc_count; i++) {
411 fb_helper->crtc_info[i].mode_set.connectors =
412 kcalloc(max_conn_count,
413 sizeof(struct drm_connector *),
416 if (!fb_helper->crtc_info[i].mode_set.connectors) {
420 fb_helper->crtc_info[i].mode_set.num_connectors = 0;
424 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
425 fb_helper->crtc_info[i].mode_set.crtc = crtc;
431 drm_fb_helper_crtc_free(fb_helper);
434 EXPORT_SYMBOL(drm_fb_helper_init);
436 void drm_fb_helper_fini(struct drm_fb_helper *fb_helper)
438 if (!list_empty(&fb_helper->kernel_fb_list)) {
439 list_del(&fb_helper->kernel_fb_list);
440 if (list_empty(&kernel_fb_helper_list)) {
441 printk(KERN_INFO "drm: unregistered panic notifier\n");
442 atomic_notifier_chain_unregister(&panic_notifier_list,
444 unregister_sysrq_key('v', &sysrq_drm_fb_helper_restore_op);
448 drm_fb_helper_crtc_free(fb_helper);
451 EXPORT_SYMBOL(drm_fb_helper_fini);
453 static int setcolreg(struct drm_crtc *crtc, u16 red, u16 green,
454 u16 blue, u16 regno, struct fb_info *info)
456 struct drm_fb_helper *fb_helper = info->par;
457 struct drm_framebuffer *fb = fb_helper->fb;
460 if (info->fix.visual == FB_VISUAL_TRUECOLOR) {
463 /* place color in psuedopalette */
466 palette = (u32 *)info->pseudo_palette;
467 red >>= (16 - info->var.red.length);
468 green >>= (16 - info->var.green.length);
469 blue >>= (16 - info->var.blue.length);
470 value = (red << info->var.red.offset) |
471 (green << info->var.green.offset) |
472 (blue << info->var.blue.offset);
473 if (info->var.transp.length > 0) {
474 u32 mask = (1 << info->var.transp.length) - 1;
475 mask <<= info->var.transp.offset;
478 palette[regno] = value;
484 if (fb->bits_per_pixel == 16) {
487 if (fb->depth == 16 && regno > 63)
489 if (fb->depth == 15 && regno > 31)
492 if (fb->depth == 16) {
496 for (i = 0; i < 8; i++)
497 fb_helper->funcs->gamma_set(crtc, red,
498 green, blue, pindex + i);
501 fb_helper->funcs->gamma_get(crtc, &r,
505 for (i = 0; i < 4; i++)
506 fb_helper->funcs->gamma_set(crtc, r,
513 fb_helper->funcs->gamma_set(crtc, red, green, blue, pindex);
517 int drm_fb_helper_setcmap(struct fb_cmap *cmap, struct fb_info *info)
519 struct drm_fb_helper *fb_helper = info->par;
520 struct drm_crtc_helper_funcs *crtc_funcs;
521 u16 *red, *green, *blue, *transp;
522 struct drm_crtc *crtc;
526 for (i = 0; i < fb_helper->crtc_count; i++) {
527 crtc = fb_helper->crtc_info[i].mode_set.crtc;
528 crtc_funcs = crtc->helper_private;
533 transp = cmap->transp;
536 for (j = 0; j < cmap->len; j++) {
537 u16 hred, hgreen, hblue, htransp = 0xffff;
546 rc = setcolreg(crtc, hred, hgreen, hblue, start++, info);
550 crtc_funcs->load_lut(crtc);
554 EXPORT_SYMBOL(drm_fb_helper_setcmap);
556 int drm_fb_helper_check_var(struct fb_var_screeninfo *var,
557 struct fb_info *info)
559 struct drm_fb_helper *fb_helper = info->par;
560 struct drm_framebuffer *fb = fb_helper->fb;
563 if (var->pixclock != 0 || in_dbg_master())
566 /* Need to resize the fb object !!! */
567 if (var->bits_per_pixel > fb->bits_per_pixel ||
568 var->xres > fb->width || var->yres > fb->height ||
569 var->xres_virtual > fb->width || var->yres_virtual > fb->height) {
570 DRM_DEBUG("fb userspace requested width/height/bpp is greater than current fb "
571 "request %dx%d-%d (virtual %dx%d) > %dx%d-%d\n",
572 var->xres, var->yres, var->bits_per_pixel,
573 var->xres_virtual, var->yres_virtual,
574 fb->width, fb->height, fb->bits_per_pixel);
578 switch (var->bits_per_pixel) {
580 depth = (var->green.length == 6) ? 16 : 15;
583 depth = (var->transp.length > 0) ? 32 : 24;
586 depth = var->bits_per_pixel;
593 var->green.offset = 0;
594 var->blue.offset = 0;
596 var->green.length = 8;
597 var->blue.length = 8;
598 var->transp.length = 0;
599 var->transp.offset = 0;
602 var->red.offset = 10;
603 var->green.offset = 5;
604 var->blue.offset = 0;
606 var->green.length = 5;
607 var->blue.length = 5;
608 var->transp.length = 1;
609 var->transp.offset = 15;
612 var->red.offset = 11;
613 var->green.offset = 5;
614 var->blue.offset = 0;
616 var->green.length = 6;
617 var->blue.length = 5;
618 var->transp.length = 0;
619 var->transp.offset = 0;
622 var->red.offset = 16;
623 var->green.offset = 8;
624 var->blue.offset = 0;
626 var->green.length = 8;
627 var->blue.length = 8;
628 var->transp.length = 0;
629 var->transp.offset = 0;
632 var->red.offset = 16;
633 var->green.offset = 8;
634 var->blue.offset = 0;
636 var->green.length = 8;
637 var->blue.length = 8;
638 var->transp.length = 8;
639 var->transp.offset = 24;
646 EXPORT_SYMBOL(drm_fb_helper_check_var);
648 /* this will let fbcon do the mode init */
649 int drm_fb_helper_set_par(struct fb_info *info)
651 struct drm_fb_helper *fb_helper = info->par;
652 struct drm_device *dev = fb_helper->dev;
653 struct fb_var_screeninfo *var = &info->var;
654 struct drm_crtc *crtc;
658 if (var->pixclock != 0) {
659 DRM_ERROR("PIXEL CLOCK SET\n");
663 mutex_lock(&dev->mode_config.mutex);
664 for (i = 0; i < fb_helper->crtc_count; i++) {
665 crtc = fb_helper->crtc_info[i].mode_set.crtc;
666 ret = crtc->funcs->set_config(&fb_helper->crtc_info[i].mode_set);
668 mutex_unlock(&dev->mode_config.mutex);
672 mutex_unlock(&dev->mode_config.mutex);
674 if (fb_helper->delayed_hotplug) {
675 fb_helper->delayed_hotplug = false;
676 drm_fb_helper_hotplug_event(fb_helper);
680 EXPORT_SYMBOL(drm_fb_helper_set_par);
682 int drm_fb_helper_pan_display(struct fb_var_screeninfo *var,
683 struct fb_info *info)
685 struct drm_fb_helper *fb_helper = info->par;
686 struct drm_device *dev = fb_helper->dev;
687 struct drm_mode_set *modeset;
688 struct drm_crtc *crtc;
692 mutex_lock(&dev->mode_config.mutex);
693 for (i = 0; i < fb_helper->crtc_count; i++) {
694 crtc = fb_helper->crtc_info[i].mode_set.crtc;
696 modeset = &fb_helper->crtc_info[i].mode_set;
698 modeset->x = var->xoffset;
699 modeset->y = var->yoffset;
701 if (modeset->num_connectors) {
702 ret = crtc->funcs->set_config(modeset);
704 info->var.xoffset = var->xoffset;
705 info->var.yoffset = var->yoffset;
709 mutex_unlock(&dev->mode_config.mutex);
712 EXPORT_SYMBOL(drm_fb_helper_pan_display);
714 int drm_fb_helper_single_fb_probe(struct drm_fb_helper *fb_helper,
720 struct fb_info *info;
721 struct drm_fb_helper_surface_size sizes;
724 memset(&sizes, 0, sizeof(struct drm_fb_helper_surface_size));
725 sizes.surface_depth = 24;
726 sizes.surface_bpp = 32;
727 sizes.fb_width = (unsigned)-1;
728 sizes.fb_height = (unsigned)-1;
730 /* if driver picks 8 or 16 by default use that
731 for both depth/bpp */
732 if (preferred_bpp != sizes.surface_bpp) {
733 sizes.surface_depth = sizes.surface_bpp = preferred_bpp;
735 /* first up get a count of crtcs now in use and new min/maxes width/heights */
736 for (i = 0; i < fb_helper->connector_count; i++) {
737 struct drm_fb_helper_connector *fb_helper_conn = fb_helper->connector_info[i];
738 struct drm_cmdline_mode *cmdline_mode;
740 cmdline_mode = &fb_helper_conn->cmdline_mode;
742 if (cmdline_mode->bpp_specified) {
743 switch (cmdline_mode->bpp) {
745 sizes.surface_depth = sizes.surface_bpp = 8;
748 sizes.surface_depth = 15;
749 sizes.surface_bpp = 16;
752 sizes.surface_depth = sizes.surface_bpp = 16;
755 sizes.surface_depth = sizes.surface_bpp = 24;
758 sizes.surface_depth = 24;
759 sizes.surface_bpp = 32;
767 for (i = 0; i < fb_helper->crtc_count; i++) {
768 struct drm_display_mode *desired_mode;
769 desired_mode = fb_helper->crtc_info[i].desired_mode;
773 gamma_size = fb_helper->crtc_info[i].mode_set.crtc->gamma_size;
774 if (desired_mode->hdisplay < sizes.fb_width)
775 sizes.fb_width = desired_mode->hdisplay;
776 if (desired_mode->vdisplay < sizes.fb_height)
777 sizes.fb_height = desired_mode->vdisplay;
778 if (desired_mode->hdisplay > sizes.surface_width)
779 sizes.surface_width = desired_mode->hdisplay;
780 if (desired_mode->vdisplay > sizes.surface_height)
781 sizes.surface_height = desired_mode->vdisplay;
786 if (crtc_count == 0 || sizes.fb_width == -1 || sizes.fb_height == -1) {
787 /* hmm everyone went away - assume VGA cable just fell out
788 and will come back later. */
789 DRM_INFO("Cannot find any crtc or sizes - going 1024x768\n");
790 sizes.fb_width = sizes.surface_width = 1024;
791 sizes.fb_height = sizes.surface_height = 768;
794 /* push down into drivers */
795 new_fb = (*fb_helper->funcs->fb_probe)(fb_helper, &sizes);
799 info = fb_helper->fbdev;
801 /* set the fb pointer */
802 for (i = 0; i < fb_helper->crtc_count; i++) {
803 fb_helper->crtc_info[i].mode_set.fb = fb_helper->fb;
807 info->var.pixclock = 0;
808 if (register_framebuffer(info) < 0) {
812 printk(KERN_INFO "fb%d: %s frame buffer device\n", info->node,
816 drm_fb_helper_set_par(info);
819 /* Switch back to kernel console on panic */
820 /* multi card linked list maybe */
821 if (list_empty(&kernel_fb_helper_list)) {
822 printk(KERN_INFO "drm: registered panic notifier\n");
823 atomic_notifier_chain_register(&panic_notifier_list,
825 register_sysrq_key('v', &sysrq_drm_fb_helper_restore_op);
828 list_add(&fb_helper->kernel_fb_list, &kernel_fb_helper_list);
832 EXPORT_SYMBOL(drm_fb_helper_single_fb_probe);
834 void drm_fb_helper_fill_fix(struct fb_info *info, uint32_t pitch,
837 info->fix.type = FB_TYPE_PACKED_PIXELS;
838 info->fix.visual = depth == 8 ? FB_VISUAL_PSEUDOCOLOR :
840 info->fix.mmio_start = 0;
841 info->fix.mmio_len = 0;
842 info->fix.type_aux = 0;
843 info->fix.xpanstep = 1; /* doing it in hw */
844 info->fix.ypanstep = 1; /* doing it in hw */
845 info->fix.ywrapstep = 0;
846 info->fix.accel = FB_ACCEL_NONE;
847 info->fix.type_aux = 0;
849 info->fix.line_length = pitch;
852 EXPORT_SYMBOL(drm_fb_helper_fill_fix);
854 void drm_fb_helper_fill_var(struct fb_info *info, struct drm_fb_helper *fb_helper,
855 uint32_t fb_width, uint32_t fb_height)
857 struct drm_framebuffer *fb = fb_helper->fb;
858 info->pseudo_palette = fb_helper->pseudo_palette;
859 info->var.xres_virtual = fb->width;
860 info->var.yres_virtual = fb->height;
861 info->var.bits_per_pixel = fb->bits_per_pixel;
862 info->var.accel_flags = FB_ACCELF_TEXT;
863 info->var.xoffset = 0;
864 info->var.yoffset = 0;
865 info->var.activate = FB_ACTIVATE_NOW;
866 info->var.height = -1;
867 info->var.width = -1;
871 info->var.red.offset = 0;
872 info->var.green.offset = 0;
873 info->var.blue.offset = 0;
874 info->var.red.length = 8; /* 8bit DAC */
875 info->var.green.length = 8;
876 info->var.blue.length = 8;
877 info->var.transp.offset = 0;
878 info->var.transp.length = 0;
881 info->var.red.offset = 10;
882 info->var.green.offset = 5;
883 info->var.blue.offset = 0;
884 info->var.red.length = 5;
885 info->var.green.length = 5;
886 info->var.blue.length = 5;
887 info->var.transp.offset = 15;
888 info->var.transp.length = 1;
891 info->var.red.offset = 11;
892 info->var.green.offset = 5;
893 info->var.blue.offset = 0;
894 info->var.red.length = 5;
895 info->var.green.length = 6;
896 info->var.blue.length = 5;
897 info->var.transp.offset = 0;
900 info->var.red.offset = 16;
901 info->var.green.offset = 8;
902 info->var.blue.offset = 0;
903 info->var.red.length = 8;
904 info->var.green.length = 8;
905 info->var.blue.length = 8;
906 info->var.transp.offset = 0;
907 info->var.transp.length = 0;
910 info->var.red.offset = 16;
911 info->var.green.offset = 8;
912 info->var.blue.offset = 0;
913 info->var.red.length = 8;
914 info->var.green.length = 8;
915 info->var.blue.length = 8;
916 info->var.transp.offset = 24;
917 info->var.transp.length = 8;
923 info->var.xres = fb_width;
924 info->var.yres = fb_height;
926 EXPORT_SYMBOL(drm_fb_helper_fill_var);
928 static int drm_fb_helper_probe_connector_modes(struct drm_fb_helper *fb_helper,
932 struct drm_connector *connector;
936 for (i = 0; i < fb_helper->connector_count; i++) {
937 connector = fb_helper->connector_info[i]->connector;
938 count += connector->funcs->fill_modes(connector, maxX, maxY);
944 static struct drm_display_mode *drm_has_preferred_mode(struct drm_fb_helper_connector *fb_connector, int width, int height)
946 struct drm_display_mode *mode;
948 list_for_each_entry(mode, &fb_connector->connector->modes, head) {
949 if (drm_mode_width(mode) > width ||
950 drm_mode_height(mode) > height)
952 if (mode->type & DRM_MODE_TYPE_PREFERRED)
958 static bool drm_has_cmdline_mode(struct drm_fb_helper_connector *fb_connector)
960 struct drm_cmdline_mode *cmdline_mode;
961 cmdline_mode = &fb_connector->cmdline_mode;
962 return cmdline_mode->specified;
965 static struct drm_display_mode *drm_pick_cmdline_mode(struct drm_fb_helper_connector *fb_helper_conn,
966 int width, int height)
968 struct drm_cmdline_mode *cmdline_mode;
969 struct drm_display_mode *mode = NULL;
971 cmdline_mode = &fb_helper_conn->cmdline_mode;
972 if (cmdline_mode->specified == false)
975 /* attempt to find a matching mode in the list of modes
976 * we have gotten so far, if not add a CVT mode that conforms
978 if (cmdline_mode->rb || cmdline_mode->margins)
981 list_for_each_entry(mode, &fb_helper_conn->connector->modes, head) {
982 /* check width/height */
983 if (mode->hdisplay != cmdline_mode->xres ||
984 mode->vdisplay != cmdline_mode->yres)
987 if (cmdline_mode->refresh_specified) {
988 if (mode->vrefresh != cmdline_mode->refresh)
992 if (cmdline_mode->interlace) {
993 if (!(mode->flags & DRM_MODE_FLAG_INTERLACE))
1000 mode = drm_mode_create_from_cmdline_mode(fb_helper_conn->connector->dev,
1002 list_add(&mode->head, &fb_helper_conn->connector->modes);
1006 static bool drm_connector_enabled(struct drm_connector *connector, bool strict)
1011 enable = connector->status == connector_status_connected;
1013 enable = connector->status != connector_status_disconnected;
1018 static void drm_enable_connectors(struct drm_fb_helper *fb_helper,
1021 bool any_enabled = false;
1022 struct drm_connector *connector;
1025 for (i = 0; i < fb_helper->connector_count; i++) {
1026 connector = fb_helper->connector_info[i]->connector;
1027 enabled[i] = drm_connector_enabled(connector, true);
1028 DRM_DEBUG_KMS("connector %d enabled? %s\n", connector->base.id,
1029 enabled[i] ? "yes" : "no");
1030 any_enabled |= enabled[i];
1036 for (i = 0; i < fb_helper->connector_count; i++) {
1037 connector = fb_helper->connector_info[i]->connector;
1038 enabled[i] = drm_connector_enabled(connector, false);
1042 static bool drm_target_cloned(struct drm_fb_helper *fb_helper,
1043 struct drm_display_mode **modes,
1044 bool *enabled, int width, int height)
1047 bool can_clone = false;
1048 struct drm_fb_helper_connector *fb_helper_conn;
1049 struct drm_display_mode *dmt_mode, *mode;
1051 /* only contemplate cloning in the single crtc case */
1052 if (fb_helper->crtc_count > 1)
1056 for (i = 0; i < fb_helper->connector_count; i++) {
1061 /* only contemplate cloning if more than one connector is enabled */
1065 /* check the command line or if nothing common pick 1024x768 */
1067 for (i = 0; i < fb_helper->connector_count; i++) {
1070 fb_helper_conn = fb_helper->connector_info[i];
1071 modes[i] = drm_pick_cmdline_mode(fb_helper_conn, width, height);
1076 for (j = 0; j < i; j++) {
1079 if (!drm_mode_equal(modes[j], modes[i]))
1085 DRM_DEBUG_KMS("can clone using command line\n");
1089 /* try and find a 1024x768 mode on each connector */
1091 dmt_mode = drm_mode_find_dmt(fb_helper->dev, 1024, 768, 60);
1093 for (i = 0; i < fb_helper->connector_count; i++) {
1098 fb_helper_conn = fb_helper->connector_info[i];
1099 list_for_each_entry(mode, &fb_helper_conn->connector->modes, head) {
1100 if (drm_mode_equal(mode, dmt_mode))
1108 DRM_DEBUG_KMS("can clone using 1024x768\n");
1111 DRM_INFO("kms: can't enable cloning when we probably wanted to.\n");
1115 static bool drm_target_preferred(struct drm_fb_helper *fb_helper,
1116 struct drm_display_mode **modes,
1117 bool *enabled, int width, int height)
1119 struct drm_fb_helper_connector *fb_helper_conn;
1122 for (i = 0; i < fb_helper->connector_count; i++) {
1123 fb_helper_conn = fb_helper->connector_info[i];
1125 if (enabled[i] == false)
1128 DRM_DEBUG_KMS("looking for cmdline mode on connector %d\n",
1129 fb_helper_conn->connector->base.id);
1131 /* got for command line mode first */
1132 modes[i] = drm_pick_cmdline_mode(fb_helper_conn, width, height);
1134 DRM_DEBUG_KMS("looking for preferred mode on connector %d\n",
1135 fb_helper_conn->connector->base.id);
1136 modes[i] = drm_has_preferred_mode(fb_helper_conn, width, height);
1138 /* No preferred modes, pick one off the list */
1139 if (!modes[i] && !list_empty(&fb_helper_conn->connector->modes)) {
1140 list_for_each_entry(modes[i], &fb_helper_conn->connector->modes, head)
1143 DRM_DEBUG_KMS("found mode %s\n", modes[i] ? modes[i]->name :
1149 static int drm_pick_crtcs(struct drm_fb_helper *fb_helper,
1150 struct drm_fb_helper_crtc **best_crtcs,
1151 struct drm_display_mode **modes,
1152 int n, int width, int height)
1155 struct drm_device *dev = fb_helper->dev;
1156 struct drm_connector *connector;
1157 struct drm_connector_helper_funcs *connector_funcs;
1158 struct drm_encoder *encoder;
1159 struct drm_fb_helper_crtc *best_crtc;
1160 int my_score, best_score, score;
1161 struct drm_fb_helper_crtc **crtcs, *crtc;
1162 struct drm_fb_helper_connector *fb_helper_conn;
1164 if (n == fb_helper->connector_count)
1167 fb_helper_conn = fb_helper->connector_info[n];
1168 connector = fb_helper_conn->connector;
1170 best_crtcs[n] = NULL;
1172 best_score = drm_pick_crtcs(fb_helper, best_crtcs, modes, n+1, width, height);
1173 if (modes[n] == NULL)
1176 crtcs = kzalloc(dev->mode_config.num_connector *
1177 sizeof(struct drm_fb_helper_crtc *), GFP_KERNEL);
1182 if (connector->status == connector_status_connected)
1184 if (drm_has_cmdline_mode(fb_helper_conn))
1186 if (drm_has_preferred_mode(fb_helper_conn, width, height))
1189 connector_funcs = connector->helper_private;
1190 encoder = connector_funcs->best_encoder(connector);
1194 /* select a crtc for this connector and then attempt to configure
1195 remaining connectors */
1196 for (c = 0; c < fb_helper->crtc_count; c++) {
1197 crtc = &fb_helper->crtc_info[c];
1199 if ((encoder->possible_crtcs & (1 << c)) == 0) {
1203 for (o = 0; o < n; o++)
1204 if (best_crtcs[o] == crtc)
1208 /* ignore cloning unless only a single crtc */
1209 if (fb_helper->crtc_count > 1)
1212 if (!drm_mode_equal(modes[o], modes[n]))
1217 memcpy(crtcs, best_crtcs, n * sizeof(struct drm_fb_helper_crtc *));
1218 score = my_score + drm_pick_crtcs(fb_helper, crtcs, modes, n + 1,
1220 if (score > best_score) {
1223 memcpy(best_crtcs, crtcs,
1224 dev->mode_config.num_connector *
1225 sizeof(struct drm_fb_helper_crtc *));
1233 static void drm_setup_crtcs(struct drm_fb_helper *fb_helper)
1235 struct drm_device *dev = fb_helper->dev;
1236 struct drm_fb_helper_crtc **crtcs;
1237 struct drm_display_mode **modes;
1238 struct drm_encoder *encoder;
1239 struct drm_mode_set *modeset;
1244 DRM_DEBUG_KMS("\n");
1246 width = dev->mode_config.max_width;
1247 height = dev->mode_config.max_height;
1249 /* clean out all the encoder/crtc combos */
1250 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
1251 encoder->crtc = NULL;
1254 crtcs = kcalloc(dev->mode_config.num_connector,
1255 sizeof(struct drm_fb_helper_crtc *), GFP_KERNEL);
1256 modes = kcalloc(dev->mode_config.num_connector,
1257 sizeof(struct drm_display_mode *), GFP_KERNEL);
1258 enabled = kcalloc(dev->mode_config.num_connector,
1259 sizeof(bool), GFP_KERNEL);
1261 drm_enable_connectors(fb_helper, enabled);
1263 ret = drm_target_cloned(fb_helper, modes, enabled, width, height);
1265 ret = drm_target_preferred(fb_helper, modes, enabled, width, height);
1267 DRM_ERROR("Unable to find initial modes\n");
1270 DRM_DEBUG_KMS("picking CRTCs for %dx%d config\n", width, height);
1272 drm_pick_crtcs(fb_helper, crtcs, modes, 0, width, height);
1274 /* need to set the modesets up here for use later */
1275 /* fill out the connector<->crtc mappings into the modesets */
1276 for (i = 0; i < fb_helper->crtc_count; i++) {
1277 modeset = &fb_helper->crtc_info[i].mode_set;
1278 modeset->num_connectors = 0;
1281 for (i = 0; i < fb_helper->connector_count; i++) {
1282 struct drm_display_mode *mode = modes[i];
1283 struct drm_fb_helper_crtc *fb_crtc = crtcs[i];
1284 modeset = &fb_crtc->mode_set;
1286 if (mode && fb_crtc) {
1287 DRM_DEBUG_KMS("desired mode %s set on crtc %d\n",
1288 mode->name, fb_crtc->mode_set.crtc->base.id);
1289 fb_crtc->desired_mode = mode;
1291 drm_mode_destroy(dev, modeset->mode);
1292 modeset->mode = drm_mode_duplicate(dev,
1293 fb_crtc->desired_mode);
1294 modeset->connectors[modeset->num_connectors++] = fb_helper->connector_info[i]->connector;
1304 * drm_helper_initial_config - setup a sane initial connector configuration
1308 * Called at init time, must take mode config lock.
1310 * Scan the CRTCs and connectors and try to put together an initial setup.
1311 * At the moment, this is a cloned configuration across all heads with
1312 * a new framebuffer object as the backing store.
1315 * Zero if everything went ok, nonzero otherwise.
1317 bool drm_fb_helper_initial_config(struct drm_fb_helper *fb_helper, int bpp_sel)
1319 struct drm_device *dev = fb_helper->dev;
1322 /* disable all the possible outputs/crtcs before entering KMS mode */
1323 drm_helper_disable_unused_functions(fb_helper->dev);
1325 drm_fb_helper_parse_command_line(fb_helper);
1327 count = drm_fb_helper_probe_connector_modes(fb_helper,
1328 dev->mode_config.max_width,
1329 dev->mode_config.max_height);
1331 * we shouldn't end up with no modes here.
1334 printk(KERN_INFO "No connectors reported connected with modes\n");
1336 drm_setup_crtcs(fb_helper);
1338 return drm_fb_helper_single_fb_probe(fb_helper, bpp_sel);
1340 EXPORT_SYMBOL(drm_fb_helper_initial_config);
1343 * drm_fb_helper_hotplug_event - respond to a hotplug notification by
1344 * probing all the outputs attached to the fb.
1345 * @fb_helper: the drm_fb_helper
1348 * Called at runtime, must take mode config lock.
1350 * Scan the connectors attached to the fb_helper and try to put together a
1351 * setup after *notification of a change in output configuration.
1354 * 0 on success and a non-zero error code otherwise.
1356 int drm_fb_helper_hotplug_event(struct drm_fb_helper *fb_helper)
1358 struct drm_device *dev = fb_helper->dev;
1360 u32 max_width, max_height, bpp_sel;
1361 bool bound = false, crtcs_bound = false;
1362 struct drm_crtc *crtc;
1367 mutex_lock(&dev->mode_config.mutex);
1368 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
1371 if (crtc->fb == fb_helper->fb)
1375 if (!bound && crtcs_bound) {
1376 fb_helper->delayed_hotplug = true;
1377 mutex_unlock(&dev->mode_config.mutex);
1380 DRM_DEBUG_KMS("\n");
1382 max_width = fb_helper->fb->width;
1383 max_height = fb_helper->fb->height;
1384 bpp_sel = fb_helper->fb->bits_per_pixel;
1386 count = drm_fb_helper_probe_connector_modes(fb_helper, max_width,
1388 drm_setup_crtcs(fb_helper);
1389 mutex_unlock(&dev->mode_config.mutex);
1391 return drm_fb_helper_single_fb_probe(fb_helper, bpp_sel);
1393 EXPORT_SYMBOL(drm_fb_helper_hotplug_event);
1395 /* The Kconfig DRM_KMS_HELPER selects FRAMEBUFFER_CONSOLE (if !EXPERT)
1396 * but the module doesn't depend on any fb console symbols. At least
1397 * attempt to load fbcon to avoid leaving the system without a usable console.
1399 #if defined(CONFIG_FRAMEBUFFER_CONSOLE_MODULE) && !defined(CONFIG_EXPERT)
1400 static int __init drm_fb_helper_modinit(void)
1402 const char *name = "fbcon";
1403 struct module *fbcon;
1405 mutex_lock(&module_mutex);
1406 fbcon = find_module(name);
1407 mutex_unlock(&module_mutex);
1410 request_module_nowait(name);
1414 module_init(drm_fb_helper_modinit);