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 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
32 #include <linux/kernel.h>
33 #include <linux/sysrq.h>
34 #include <linux/slab.h>
36 #include <linux/module.h>
38 #include <drm/drm_crtc.h>
39 #include <drm/drm_fb_helper.h>
40 #include <drm/drm_crtc_helper.h>
42 MODULE_AUTHOR("David Airlie, Jesse Barnes");
43 MODULE_DESCRIPTION("DRM KMS helper");
44 MODULE_LICENSE("GPL and additional rights");
46 static LIST_HEAD(kernel_fb_helper_list);
51 * The fb helper functions are useful to provide an fbdev on top of a drm kernel
52 * mode setting driver. They can be used mostly independantely from the crtc
53 * helper functions used by many drivers to implement the kernel mode setting
57 /* simple single crtc case helper function */
58 int drm_fb_helper_single_add_all_connectors(struct drm_fb_helper *fb_helper)
60 struct drm_device *dev = fb_helper->dev;
61 struct drm_connector *connector;
64 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
65 struct drm_fb_helper_connector *fb_helper_connector;
67 fb_helper_connector = kzalloc(sizeof(struct drm_fb_helper_connector), GFP_KERNEL);
68 if (!fb_helper_connector)
71 fb_helper_connector->connector = connector;
72 fb_helper->connector_info[fb_helper->connector_count++] = fb_helper_connector;
76 for (i = 0; i < fb_helper->connector_count; i++) {
77 kfree(fb_helper->connector_info[i]);
78 fb_helper->connector_info[i] = NULL;
80 fb_helper->connector_count = 0;
83 EXPORT_SYMBOL(drm_fb_helper_single_add_all_connectors);
85 static int drm_fb_helper_parse_command_line(struct drm_fb_helper *fb_helper)
87 struct drm_fb_helper_connector *fb_helper_conn;
90 for (i = 0; i < fb_helper->connector_count; i++) {
91 struct drm_cmdline_mode *mode;
92 struct drm_connector *connector;
95 fb_helper_conn = fb_helper->connector_info[i];
96 connector = fb_helper_conn->connector;
97 mode = &fb_helper_conn->cmdline_mode;
99 /* do something on return - turn off connector maybe */
100 if (fb_get_options(drm_get_connector_name(connector), &option))
103 if (drm_mode_parse_command_line_for_connector(option,
108 switch (mode->force) {
112 case DRM_FORCE_ON_DIGITAL:
121 DRM_INFO("forcing %s connector %s\n",
122 drm_get_connector_name(connector), s);
123 connector->force = mode->force;
126 DRM_DEBUG_KMS("cmdline mode for connector %s %dx%d@%dHz%s%s%s\n",
127 drm_get_connector_name(connector),
128 mode->xres, mode->yres,
129 mode->refresh_specified ? mode->refresh : 60,
130 mode->rb ? " reduced blanking" : "",
131 mode->margins ? " with margins" : "",
132 mode->interlace ? " interlaced" : "");
139 static void drm_fb_helper_save_lut_atomic(struct drm_crtc *crtc, struct drm_fb_helper *helper)
141 uint16_t *r_base, *g_base, *b_base;
144 r_base = crtc->gamma_store;
145 g_base = r_base + crtc->gamma_size;
146 b_base = g_base + crtc->gamma_size;
148 for (i = 0; i < crtc->gamma_size; i++)
149 helper->funcs->gamma_get(crtc, &r_base[i], &g_base[i], &b_base[i], i);
152 static void drm_fb_helper_restore_lut_atomic(struct drm_crtc *crtc)
154 uint16_t *r_base, *g_base, *b_base;
156 if (crtc->funcs->gamma_set == NULL)
159 r_base = crtc->gamma_store;
160 g_base = r_base + crtc->gamma_size;
161 b_base = g_base + crtc->gamma_size;
163 crtc->funcs->gamma_set(crtc, r_base, g_base, b_base, 0, crtc->gamma_size);
166 int drm_fb_helper_debug_enter(struct fb_info *info)
168 struct drm_fb_helper *helper = info->par;
169 struct drm_crtc_helper_funcs *funcs;
172 if (list_empty(&kernel_fb_helper_list))
175 list_for_each_entry(helper, &kernel_fb_helper_list, kernel_fb_list) {
176 for (i = 0; i < helper->crtc_count; i++) {
177 struct drm_mode_set *mode_set =
178 &helper->crtc_info[i].mode_set;
180 if (!mode_set->crtc->enabled)
183 funcs = mode_set->crtc->helper_private;
184 drm_fb_helper_save_lut_atomic(mode_set->crtc, helper);
185 funcs->mode_set_base_atomic(mode_set->crtc,
189 ENTER_ATOMIC_MODE_SET);
195 EXPORT_SYMBOL(drm_fb_helper_debug_enter);
197 /* Find the real fb for a given fb helper CRTC */
198 static struct drm_framebuffer *drm_mode_config_fb(struct drm_crtc *crtc)
200 struct drm_device *dev = crtc->dev;
203 list_for_each_entry(c, &dev->mode_config.crtc_list, head) {
204 if (crtc->base.id == c->base.id)
211 int drm_fb_helper_debug_leave(struct fb_info *info)
213 struct drm_fb_helper *helper = info->par;
214 struct drm_crtc *crtc;
215 struct drm_crtc_helper_funcs *funcs;
216 struct drm_framebuffer *fb;
219 for (i = 0; i < helper->crtc_count; i++) {
220 struct drm_mode_set *mode_set = &helper->crtc_info[i].mode_set;
221 crtc = mode_set->crtc;
222 funcs = crtc->helper_private;
223 fb = drm_mode_config_fb(crtc);
229 DRM_ERROR("no fb to restore??\n");
233 drm_fb_helper_restore_lut_atomic(mode_set->crtc);
234 funcs->mode_set_base_atomic(mode_set->crtc, fb, crtc->x,
235 crtc->y, LEAVE_ATOMIC_MODE_SET);
240 EXPORT_SYMBOL(drm_fb_helper_debug_leave);
242 bool drm_fb_helper_restore_fbdev_mode(struct drm_fb_helper *fb_helper)
246 for (i = 0; i < fb_helper->crtc_count; i++) {
247 struct drm_mode_set *mode_set = &fb_helper->crtc_info[i].mode_set;
248 ret = mode_set->crtc->funcs->set_config(mode_set);
254 EXPORT_SYMBOL(drm_fb_helper_restore_fbdev_mode);
256 static bool drm_fb_helper_force_kernel_mode(void)
258 bool ret, error = false;
259 struct drm_fb_helper *helper;
261 if (list_empty(&kernel_fb_helper_list))
264 list_for_each_entry(helper, &kernel_fb_helper_list, kernel_fb_list) {
265 if (helper->dev->switch_power_state == DRM_SWITCH_POWER_OFF)
268 ret = drm_fb_helper_restore_fbdev_mode(helper);
275 int drm_fb_helper_panic(struct notifier_block *n, unsigned long ununsed,
279 * It's a waste of time and effort to switch back to text console
280 * if the kernel should reboot before panic messages can be seen.
282 if (panic_timeout < 0)
285 pr_err("panic occurred, switching back to text console\n");
286 return drm_fb_helper_force_kernel_mode();
288 EXPORT_SYMBOL(drm_fb_helper_panic);
290 static struct notifier_block paniced = {
291 .notifier_call = drm_fb_helper_panic,
295 * drm_fb_helper_restore - restore the framebuffer console (kernel) config
297 * Restore's the kernel's fbcon mode, used for lastclose & panic paths.
299 void drm_fb_helper_restore(void)
302 ret = drm_fb_helper_force_kernel_mode();
304 DRM_ERROR("Failed to restore crtc configuration\n");
306 EXPORT_SYMBOL(drm_fb_helper_restore);
308 #ifdef CONFIG_MAGIC_SYSRQ
309 static void drm_fb_helper_restore_work_fn(struct work_struct *ignored)
311 drm_fb_helper_restore();
313 static DECLARE_WORK(drm_fb_helper_restore_work, drm_fb_helper_restore_work_fn);
315 static void drm_fb_helper_sysrq(int dummy1)
317 schedule_work(&drm_fb_helper_restore_work);
320 static struct sysrq_key_op sysrq_drm_fb_helper_restore_op = {
321 .handler = drm_fb_helper_sysrq,
322 .help_msg = "force-fb(V)",
323 .action_msg = "Restore framebuffer console",
326 static struct sysrq_key_op sysrq_drm_fb_helper_restore_op = { };
329 static void drm_fb_helper_dpms(struct fb_info *info, int dpms_mode)
331 struct drm_fb_helper *fb_helper = info->par;
332 struct drm_device *dev = fb_helper->dev;
333 struct drm_crtc *crtc;
334 struct drm_connector *connector;
338 * For each CRTC in this fb, turn the connectors on/off.
340 mutex_lock(&dev->mode_config.mutex);
341 for (i = 0; i < fb_helper->crtc_count; i++) {
342 crtc = fb_helper->crtc_info[i].mode_set.crtc;
347 /* Walk the connectors & encoders on this fb turning them on/off */
348 for (j = 0; j < fb_helper->connector_count; j++) {
349 connector = fb_helper->connector_info[j]->connector;
350 connector->funcs->dpms(connector, dpms_mode);
351 drm_object_property_set_value(&connector->base,
352 dev->mode_config.dpms_property, dpms_mode);
355 mutex_unlock(&dev->mode_config.mutex);
358 int drm_fb_helper_blank(int blank, struct fb_info *info)
361 /* Display: On; HSync: On, VSync: On */
362 case FB_BLANK_UNBLANK:
363 drm_fb_helper_dpms(info, DRM_MODE_DPMS_ON);
365 /* Display: Off; HSync: On, VSync: On */
366 case FB_BLANK_NORMAL:
367 drm_fb_helper_dpms(info, DRM_MODE_DPMS_STANDBY);
369 /* Display: Off; HSync: Off, VSync: On */
370 case FB_BLANK_HSYNC_SUSPEND:
371 drm_fb_helper_dpms(info, DRM_MODE_DPMS_STANDBY);
373 /* Display: Off; HSync: On, VSync: Off */
374 case FB_BLANK_VSYNC_SUSPEND:
375 drm_fb_helper_dpms(info, DRM_MODE_DPMS_SUSPEND);
377 /* Display: Off; HSync: Off, VSync: Off */
378 case FB_BLANK_POWERDOWN:
379 drm_fb_helper_dpms(info, DRM_MODE_DPMS_OFF);
384 EXPORT_SYMBOL(drm_fb_helper_blank);
386 static void drm_fb_helper_crtc_free(struct drm_fb_helper *helper)
390 for (i = 0; i < helper->connector_count; i++)
391 kfree(helper->connector_info[i]);
392 kfree(helper->connector_info);
393 for (i = 0; i < helper->crtc_count; i++) {
394 kfree(helper->crtc_info[i].mode_set.connectors);
395 if (helper->crtc_info[i].mode_set.mode)
396 drm_mode_destroy(helper->dev, helper->crtc_info[i].mode_set.mode);
398 kfree(helper->crtc_info);
401 int drm_fb_helper_init(struct drm_device *dev,
402 struct drm_fb_helper *fb_helper,
403 int crtc_count, int max_conn_count)
405 struct drm_crtc *crtc;
408 fb_helper->dev = dev;
410 INIT_LIST_HEAD(&fb_helper->kernel_fb_list);
412 fb_helper->crtc_info = kcalloc(crtc_count, sizeof(struct drm_fb_helper_crtc), GFP_KERNEL);
413 if (!fb_helper->crtc_info)
416 fb_helper->crtc_count = crtc_count;
417 fb_helper->connector_info = kcalloc(dev->mode_config.num_connector, sizeof(struct drm_fb_helper_connector *), GFP_KERNEL);
418 if (!fb_helper->connector_info) {
419 kfree(fb_helper->crtc_info);
422 fb_helper->connector_count = 0;
424 for (i = 0; i < crtc_count; i++) {
425 fb_helper->crtc_info[i].mode_set.connectors =
426 kcalloc(max_conn_count,
427 sizeof(struct drm_connector *),
430 if (!fb_helper->crtc_info[i].mode_set.connectors)
432 fb_helper->crtc_info[i].mode_set.num_connectors = 0;
436 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
437 fb_helper->crtc_info[i].mode_set.crtc = crtc;
443 drm_fb_helper_crtc_free(fb_helper);
446 EXPORT_SYMBOL(drm_fb_helper_init);
448 void drm_fb_helper_fini(struct drm_fb_helper *fb_helper)
450 if (!list_empty(&fb_helper->kernel_fb_list)) {
451 list_del(&fb_helper->kernel_fb_list);
452 if (list_empty(&kernel_fb_helper_list)) {
453 pr_info("drm: unregistered panic notifier\n");
454 atomic_notifier_chain_unregister(&panic_notifier_list,
456 unregister_sysrq_key('v', &sysrq_drm_fb_helper_restore_op);
460 drm_fb_helper_crtc_free(fb_helper);
463 EXPORT_SYMBOL(drm_fb_helper_fini);
465 static int setcolreg(struct drm_crtc *crtc, u16 red, u16 green,
466 u16 blue, u16 regno, struct fb_info *info)
468 struct drm_fb_helper *fb_helper = info->par;
469 struct drm_framebuffer *fb = fb_helper->fb;
472 if (info->fix.visual == FB_VISUAL_TRUECOLOR) {
475 /* place color in psuedopalette */
478 palette = (u32 *)info->pseudo_palette;
479 red >>= (16 - info->var.red.length);
480 green >>= (16 - info->var.green.length);
481 blue >>= (16 - info->var.blue.length);
482 value = (red << info->var.red.offset) |
483 (green << info->var.green.offset) |
484 (blue << info->var.blue.offset);
485 if (info->var.transp.length > 0) {
486 u32 mask = (1 << info->var.transp.length) - 1;
487 mask <<= info->var.transp.offset;
490 palette[regno] = value;
496 if (fb->bits_per_pixel == 16) {
499 if (fb->depth == 16 && regno > 63)
501 if (fb->depth == 15 && regno > 31)
504 if (fb->depth == 16) {
508 for (i = 0; i < 8; i++)
509 fb_helper->funcs->gamma_set(crtc, red,
510 green, blue, pindex + i);
513 fb_helper->funcs->gamma_get(crtc, &r,
517 for (i = 0; i < 4; i++)
518 fb_helper->funcs->gamma_set(crtc, r,
525 fb_helper->funcs->gamma_set(crtc, red, green, blue, pindex);
529 int drm_fb_helper_setcmap(struct fb_cmap *cmap, struct fb_info *info)
531 struct drm_fb_helper *fb_helper = info->par;
532 struct drm_crtc_helper_funcs *crtc_funcs;
533 u16 *red, *green, *blue, *transp;
534 struct drm_crtc *crtc;
538 for (i = 0; i < fb_helper->crtc_count; i++) {
539 crtc = fb_helper->crtc_info[i].mode_set.crtc;
540 crtc_funcs = crtc->helper_private;
545 transp = cmap->transp;
548 for (j = 0; j < cmap->len; j++) {
549 u16 hred, hgreen, hblue, htransp = 0xffff;
558 rc = setcolreg(crtc, hred, hgreen, hblue, start++, info);
562 crtc_funcs->load_lut(crtc);
566 EXPORT_SYMBOL(drm_fb_helper_setcmap);
568 int drm_fb_helper_check_var(struct fb_var_screeninfo *var,
569 struct fb_info *info)
571 struct drm_fb_helper *fb_helper = info->par;
572 struct drm_framebuffer *fb = fb_helper->fb;
575 if (var->pixclock != 0 || in_dbg_master())
578 /* Need to resize the fb object !!! */
579 if (var->bits_per_pixel > fb->bits_per_pixel ||
580 var->xres > fb->width || var->yres > fb->height ||
581 var->xres_virtual > fb->width || var->yres_virtual > fb->height) {
582 DRM_DEBUG("fb userspace requested width/height/bpp is greater than current fb "
583 "request %dx%d-%d (virtual %dx%d) > %dx%d-%d\n",
584 var->xres, var->yres, var->bits_per_pixel,
585 var->xres_virtual, var->yres_virtual,
586 fb->width, fb->height, fb->bits_per_pixel);
590 switch (var->bits_per_pixel) {
592 depth = (var->green.length == 6) ? 16 : 15;
595 depth = (var->transp.length > 0) ? 32 : 24;
598 depth = var->bits_per_pixel;
605 var->green.offset = 0;
606 var->blue.offset = 0;
608 var->green.length = 8;
609 var->blue.length = 8;
610 var->transp.length = 0;
611 var->transp.offset = 0;
614 var->red.offset = 10;
615 var->green.offset = 5;
616 var->blue.offset = 0;
618 var->green.length = 5;
619 var->blue.length = 5;
620 var->transp.length = 1;
621 var->transp.offset = 15;
624 var->red.offset = 11;
625 var->green.offset = 5;
626 var->blue.offset = 0;
628 var->green.length = 6;
629 var->blue.length = 5;
630 var->transp.length = 0;
631 var->transp.offset = 0;
634 var->red.offset = 16;
635 var->green.offset = 8;
636 var->blue.offset = 0;
638 var->green.length = 8;
639 var->blue.length = 8;
640 var->transp.length = 0;
641 var->transp.offset = 0;
644 var->red.offset = 16;
645 var->green.offset = 8;
646 var->blue.offset = 0;
648 var->green.length = 8;
649 var->blue.length = 8;
650 var->transp.length = 8;
651 var->transp.offset = 24;
658 EXPORT_SYMBOL(drm_fb_helper_check_var);
660 /* this will let fbcon do the mode init */
661 int drm_fb_helper_set_par(struct fb_info *info)
663 struct drm_fb_helper *fb_helper = info->par;
664 struct drm_device *dev = fb_helper->dev;
665 struct fb_var_screeninfo *var = &info->var;
666 struct drm_crtc *crtc;
670 if (var->pixclock != 0) {
671 DRM_ERROR("PIXEL CLOCK SET\n");
675 mutex_lock(&dev->mode_config.mutex);
676 for (i = 0; i < fb_helper->crtc_count; i++) {
677 crtc = fb_helper->crtc_info[i].mode_set.crtc;
678 ret = crtc->funcs->set_config(&fb_helper->crtc_info[i].mode_set);
680 mutex_unlock(&dev->mode_config.mutex);
684 mutex_unlock(&dev->mode_config.mutex);
686 if (fb_helper->delayed_hotplug) {
687 fb_helper->delayed_hotplug = false;
688 drm_fb_helper_hotplug_event(fb_helper);
692 EXPORT_SYMBOL(drm_fb_helper_set_par);
694 int drm_fb_helper_pan_display(struct fb_var_screeninfo *var,
695 struct fb_info *info)
697 struct drm_fb_helper *fb_helper = info->par;
698 struct drm_device *dev = fb_helper->dev;
699 struct drm_mode_set *modeset;
700 struct drm_crtc *crtc;
704 mutex_lock(&dev->mode_config.mutex);
705 for (i = 0; i < fb_helper->crtc_count; i++) {
706 crtc = fb_helper->crtc_info[i].mode_set.crtc;
708 modeset = &fb_helper->crtc_info[i].mode_set;
710 modeset->x = var->xoffset;
711 modeset->y = var->yoffset;
713 if (modeset->num_connectors) {
714 ret = crtc->funcs->set_config(modeset);
716 info->var.xoffset = var->xoffset;
717 info->var.yoffset = var->yoffset;
721 mutex_unlock(&dev->mode_config.mutex);
724 EXPORT_SYMBOL(drm_fb_helper_pan_display);
726 int drm_fb_helper_single_fb_probe(struct drm_fb_helper *fb_helper,
732 struct fb_info *info;
733 struct drm_fb_helper_surface_size sizes;
736 memset(&sizes, 0, sizeof(struct drm_fb_helper_surface_size));
737 sizes.surface_depth = 24;
738 sizes.surface_bpp = 32;
739 sizes.fb_width = (unsigned)-1;
740 sizes.fb_height = (unsigned)-1;
742 /* if driver picks 8 or 16 by default use that
743 for both depth/bpp */
744 if (preferred_bpp != sizes.surface_bpp)
745 sizes.surface_depth = sizes.surface_bpp = preferred_bpp;
747 /* first up get a count of crtcs now in use and new min/maxes width/heights */
748 for (i = 0; i < fb_helper->connector_count; i++) {
749 struct drm_fb_helper_connector *fb_helper_conn = fb_helper->connector_info[i];
750 struct drm_cmdline_mode *cmdline_mode;
752 cmdline_mode = &fb_helper_conn->cmdline_mode;
754 if (cmdline_mode->bpp_specified) {
755 switch (cmdline_mode->bpp) {
757 sizes.surface_depth = sizes.surface_bpp = 8;
760 sizes.surface_depth = 15;
761 sizes.surface_bpp = 16;
764 sizes.surface_depth = sizes.surface_bpp = 16;
767 sizes.surface_depth = sizes.surface_bpp = 24;
770 sizes.surface_depth = 24;
771 sizes.surface_bpp = 32;
779 for (i = 0; i < fb_helper->crtc_count; i++) {
780 struct drm_display_mode *desired_mode;
781 desired_mode = fb_helper->crtc_info[i].desired_mode;
785 gamma_size = fb_helper->crtc_info[i].mode_set.crtc->gamma_size;
786 if (desired_mode->hdisplay < sizes.fb_width)
787 sizes.fb_width = desired_mode->hdisplay;
788 if (desired_mode->vdisplay < sizes.fb_height)
789 sizes.fb_height = desired_mode->vdisplay;
790 if (desired_mode->hdisplay > sizes.surface_width)
791 sizes.surface_width = desired_mode->hdisplay;
792 if (desired_mode->vdisplay > sizes.surface_height)
793 sizes.surface_height = desired_mode->vdisplay;
798 if (crtc_count == 0 || sizes.fb_width == -1 || sizes.fb_height == -1) {
799 /* hmm everyone went away - assume VGA cable just fell out
800 and will come back later. */
801 DRM_INFO("Cannot find any crtc or sizes - going 1024x768\n");
802 sizes.fb_width = sizes.surface_width = 1024;
803 sizes.fb_height = sizes.surface_height = 768;
806 /* push down into drivers */
807 new_fb = (*fb_helper->funcs->fb_probe)(fb_helper, &sizes);
811 info = fb_helper->fbdev;
813 /* set the fb pointer */
814 for (i = 0; i < fb_helper->crtc_count; i++)
815 fb_helper->crtc_info[i].mode_set.fb = fb_helper->fb;
818 info->var.pixclock = 0;
819 if (register_framebuffer(info) < 0)
822 dev_info(fb_helper->dev->dev, "fb%d: %s frame buffer device\n",
823 info->node, info->fix.id);
826 drm_fb_helper_set_par(info);
829 /* Switch back to kernel console on panic */
830 /* multi card linked list maybe */
831 if (list_empty(&kernel_fb_helper_list)) {
832 dev_info(fb_helper->dev->dev, "registered panic notifier\n");
833 atomic_notifier_chain_register(&panic_notifier_list,
835 register_sysrq_key('v', &sysrq_drm_fb_helper_restore_op);
838 list_add(&fb_helper->kernel_fb_list, &kernel_fb_helper_list);
842 EXPORT_SYMBOL(drm_fb_helper_single_fb_probe);
844 void drm_fb_helper_fill_fix(struct fb_info *info, uint32_t pitch,
847 info->fix.type = FB_TYPE_PACKED_PIXELS;
848 info->fix.visual = depth == 8 ? FB_VISUAL_PSEUDOCOLOR :
850 info->fix.mmio_start = 0;
851 info->fix.mmio_len = 0;
852 info->fix.type_aux = 0;
853 info->fix.xpanstep = 1; /* doing it in hw */
854 info->fix.ypanstep = 1; /* doing it in hw */
855 info->fix.ywrapstep = 0;
856 info->fix.accel = FB_ACCEL_NONE;
857 info->fix.type_aux = 0;
859 info->fix.line_length = pitch;
862 EXPORT_SYMBOL(drm_fb_helper_fill_fix);
864 void drm_fb_helper_fill_var(struct fb_info *info, struct drm_fb_helper *fb_helper,
865 uint32_t fb_width, uint32_t fb_height)
867 struct drm_framebuffer *fb = fb_helper->fb;
868 info->pseudo_palette = fb_helper->pseudo_palette;
869 info->var.xres_virtual = fb->width;
870 info->var.yres_virtual = fb->height;
871 info->var.bits_per_pixel = fb->bits_per_pixel;
872 info->var.accel_flags = FB_ACCELF_TEXT;
873 info->var.xoffset = 0;
874 info->var.yoffset = 0;
875 info->var.activate = FB_ACTIVATE_NOW;
876 info->var.height = -1;
877 info->var.width = -1;
881 info->var.red.offset = 0;
882 info->var.green.offset = 0;
883 info->var.blue.offset = 0;
884 info->var.red.length = 8; /* 8bit DAC */
885 info->var.green.length = 8;
886 info->var.blue.length = 8;
887 info->var.transp.offset = 0;
888 info->var.transp.length = 0;
891 info->var.red.offset = 10;
892 info->var.green.offset = 5;
893 info->var.blue.offset = 0;
894 info->var.red.length = 5;
895 info->var.green.length = 5;
896 info->var.blue.length = 5;
897 info->var.transp.offset = 15;
898 info->var.transp.length = 1;
901 info->var.red.offset = 11;
902 info->var.green.offset = 5;
903 info->var.blue.offset = 0;
904 info->var.red.length = 5;
905 info->var.green.length = 6;
906 info->var.blue.length = 5;
907 info->var.transp.offset = 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 = 0;
917 info->var.transp.length = 0;
920 info->var.red.offset = 16;
921 info->var.green.offset = 8;
922 info->var.blue.offset = 0;
923 info->var.red.length = 8;
924 info->var.green.length = 8;
925 info->var.blue.length = 8;
926 info->var.transp.offset = 24;
927 info->var.transp.length = 8;
933 info->var.xres = fb_width;
934 info->var.yres = fb_height;
936 EXPORT_SYMBOL(drm_fb_helper_fill_var);
938 static int drm_fb_helper_probe_connector_modes(struct drm_fb_helper *fb_helper,
942 struct drm_connector *connector;
946 for (i = 0; i < fb_helper->connector_count; i++) {
947 connector = fb_helper->connector_info[i]->connector;
948 count += connector->funcs->fill_modes(connector, maxX, maxY);
954 static struct drm_display_mode *drm_has_preferred_mode(struct drm_fb_helper_connector *fb_connector, int width, int height)
956 struct drm_display_mode *mode;
958 list_for_each_entry(mode, &fb_connector->connector->modes, head) {
959 if (drm_mode_width(mode) > width ||
960 drm_mode_height(mode) > height)
962 if (mode->type & DRM_MODE_TYPE_PREFERRED)
968 static bool drm_has_cmdline_mode(struct drm_fb_helper_connector *fb_connector)
970 struct drm_cmdline_mode *cmdline_mode;
971 cmdline_mode = &fb_connector->cmdline_mode;
972 return cmdline_mode->specified;
975 static struct drm_display_mode *drm_pick_cmdline_mode(struct drm_fb_helper_connector *fb_helper_conn,
976 int width, int height)
978 struct drm_cmdline_mode *cmdline_mode;
979 struct drm_display_mode *mode = NULL;
981 cmdline_mode = &fb_helper_conn->cmdline_mode;
982 if (cmdline_mode->specified == false)
985 /* attempt to find a matching mode in the list of modes
986 * we have gotten so far, if not add a CVT mode that conforms
988 if (cmdline_mode->rb || cmdline_mode->margins)
991 list_for_each_entry(mode, &fb_helper_conn->connector->modes, head) {
992 /* check width/height */
993 if (mode->hdisplay != cmdline_mode->xres ||
994 mode->vdisplay != cmdline_mode->yres)
997 if (cmdline_mode->refresh_specified) {
998 if (mode->vrefresh != cmdline_mode->refresh)
1002 if (cmdline_mode->interlace) {
1003 if (!(mode->flags & DRM_MODE_FLAG_INTERLACE))
1010 mode = drm_mode_create_from_cmdline_mode(fb_helper_conn->connector->dev,
1012 list_add(&mode->head, &fb_helper_conn->connector->modes);
1016 static bool drm_connector_enabled(struct drm_connector *connector, bool strict)
1021 enable = connector->status == connector_status_connected;
1023 enable = connector->status != connector_status_disconnected;
1028 static void drm_enable_connectors(struct drm_fb_helper *fb_helper,
1031 bool any_enabled = false;
1032 struct drm_connector *connector;
1035 for (i = 0; i < fb_helper->connector_count; i++) {
1036 connector = fb_helper->connector_info[i]->connector;
1037 enabled[i] = drm_connector_enabled(connector, true);
1038 DRM_DEBUG_KMS("connector %d enabled? %s\n", connector->base.id,
1039 enabled[i] ? "yes" : "no");
1040 any_enabled |= enabled[i];
1046 for (i = 0; i < fb_helper->connector_count; i++) {
1047 connector = fb_helper->connector_info[i]->connector;
1048 enabled[i] = drm_connector_enabled(connector, false);
1052 static bool drm_target_cloned(struct drm_fb_helper *fb_helper,
1053 struct drm_display_mode **modes,
1054 bool *enabled, int width, int height)
1057 bool can_clone = false;
1058 struct drm_fb_helper_connector *fb_helper_conn;
1059 struct drm_display_mode *dmt_mode, *mode;
1061 /* only contemplate cloning in the single crtc case */
1062 if (fb_helper->crtc_count > 1)
1066 for (i = 0; i < fb_helper->connector_count; i++) {
1071 /* only contemplate cloning if more than one connector is enabled */
1075 /* check the command line or if nothing common pick 1024x768 */
1077 for (i = 0; i < fb_helper->connector_count; i++) {
1080 fb_helper_conn = fb_helper->connector_info[i];
1081 modes[i] = drm_pick_cmdline_mode(fb_helper_conn, width, height);
1086 for (j = 0; j < i; j++) {
1089 if (!drm_mode_equal(modes[j], modes[i]))
1095 DRM_DEBUG_KMS("can clone using command line\n");
1099 /* try and find a 1024x768 mode on each connector */
1101 dmt_mode = drm_mode_find_dmt(fb_helper->dev, 1024, 768, 60, false);
1103 for (i = 0; i < fb_helper->connector_count; i++) {
1108 fb_helper_conn = fb_helper->connector_info[i];
1109 list_for_each_entry(mode, &fb_helper_conn->connector->modes, head) {
1110 if (drm_mode_equal(mode, dmt_mode))
1118 DRM_DEBUG_KMS("can clone using 1024x768\n");
1121 DRM_INFO("kms: can't enable cloning when we probably wanted to.\n");
1125 static bool drm_target_preferred(struct drm_fb_helper *fb_helper,
1126 struct drm_display_mode **modes,
1127 bool *enabled, int width, int height)
1129 struct drm_fb_helper_connector *fb_helper_conn;
1132 for (i = 0; i < fb_helper->connector_count; i++) {
1133 fb_helper_conn = fb_helper->connector_info[i];
1135 if (enabled[i] == false)
1138 DRM_DEBUG_KMS("looking for cmdline mode on connector %d\n",
1139 fb_helper_conn->connector->base.id);
1141 /* got for command line mode first */
1142 modes[i] = drm_pick_cmdline_mode(fb_helper_conn, width, height);
1144 DRM_DEBUG_KMS("looking for preferred mode on connector %d\n",
1145 fb_helper_conn->connector->base.id);
1146 modes[i] = drm_has_preferred_mode(fb_helper_conn, width, height);
1148 /* No preferred modes, pick one off the list */
1149 if (!modes[i] && !list_empty(&fb_helper_conn->connector->modes)) {
1150 list_for_each_entry(modes[i], &fb_helper_conn->connector->modes, head)
1153 DRM_DEBUG_KMS("found mode %s\n", modes[i] ? modes[i]->name :
1159 static int drm_pick_crtcs(struct drm_fb_helper *fb_helper,
1160 struct drm_fb_helper_crtc **best_crtcs,
1161 struct drm_display_mode **modes,
1162 int n, int width, int height)
1165 struct drm_device *dev = fb_helper->dev;
1166 struct drm_connector *connector;
1167 struct drm_connector_helper_funcs *connector_funcs;
1168 struct drm_encoder *encoder;
1169 struct drm_fb_helper_crtc *best_crtc;
1170 int my_score, best_score, score;
1171 struct drm_fb_helper_crtc **crtcs, *crtc;
1172 struct drm_fb_helper_connector *fb_helper_conn;
1174 if (n == fb_helper->connector_count)
1177 fb_helper_conn = fb_helper->connector_info[n];
1178 connector = fb_helper_conn->connector;
1180 best_crtcs[n] = NULL;
1182 best_score = drm_pick_crtcs(fb_helper, best_crtcs, modes, n+1, width, height);
1183 if (modes[n] == NULL)
1186 crtcs = kzalloc(dev->mode_config.num_connector *
1187 sizeof(struct drm_fb_helper_crtc *), GFP_KERNEL);
1192 if (connector->status == connector_status_connected)
1194 if (drm_has_cmdline_mode(fb_helper_conn))
1196 if (drm_has_preferred_mode(fb_helper_conn, width, height))
1199 connector_funcs = connector->helper_private;
1200 encoder = connector_funcs->best_encoder(connector);
1204 /* select a crtc for this connector and then attempt to configure
1205 remaining connectors */
1206 for (c = 0; c < fb_helper->crtc_count; c++) {
1207 crtc = &fb_helper->crtc_info[c];
1209 if ((encoder->possible_crtcs & (1 << c)) == 0)
1212 for (o = 0; o < n; o++)
1213 if (best_crtcs[o] == crtc)
1217 /* ignore cloning unless only a single crtc */
1218 if (fb_helper->crtc_count > 1)
1221 if (!drm_mode_equal(modes[o], modes[n]))
1226 memcpy(crtcs, best_crtcs, n * sizeof(struct drm_fb_helper_crtc *));
1227 score = my_score + drm_pick_crtcs(fb_helper, crtcs, modes, n + 1,
1229 if (score > best_score) {
1232 memcpy(best_crtcs, crtcs,
1233 dev->mode_config.num_connector *
1234 sizeof(struct drm_fb_helper_crtc *));
1242 static void drm_setup_crtcs(struct drm_fb_helper *fb_helper)
1244 struct drm_device *dev = fb_helper->dev;
1245 struct drm_fb_helper_crtc **crtcs;
1246 struct drm_display_mode **modes;
1247 struct drm_mode_set *modeset;
1252 DRM_DEBUG_KMS("\n");
1254 width = dev->mode_config.max_width;
1255 height = dev->mode_config.max_height;
1257 crtcs = kcalloc(dev->mode_config.num_connector,
1258 sizeof(struct drm_fb_helper_crtc *), GFP_KERNEL);
1259 modes = kcalloc(dev->mode_config.num_connector,
1260 sizeof(struct drm_display_mode *), GFP_KERNEL);
1261 enabled = kcalloc(dev->mode_config.num_connector,
1262 sizeof(bool), GFP_KERNEL);
1263 if (!crtcs || !modes || !enabled) {
1264 DRM_ERROR("Memory allocation failed\n");
1269 drm_enable_connectors(fb_helper, enabled);
1271 ret = drm_target_cloned(fb_helper, modes, enabled, width, height);
1273 ret = drm_target_preferred(fb_helper, modes, enabled, width, height);
1275 DRM_ERROR("Unable to find initial modes\n");
1278 DRM_DEBUG_KMS("picking CRTCs for %dx%d config\n", width, height);
1280 drm_pick_crtcs(fb_helper, crtcs, modes, 0, width, height);
1282 /* need to set the modesets up here for use later */
1283 /* fill out the connector<->crtc mappings into the modesets */
1284 for (i = 0; i < fb_helper->crtc_count; i++) {
1285 modeset = &fb_helper->crtc_info[i].mode_set;
1286 modeset->num_connectors = 0;
1289 for (i = 0; i < fb_helper->connector_count; i++) {
1290 struct drm_display_mode *mode = modes[i];
1291 struct drm_fb_helper_crtc *fb_crtc = crtcs[i];
1292 modeset = &fb_crtc->mode_set;
1294 if (mode && fb_crtc) {
1295 DRM_DEBUG_KMS("desired mode %s set on crtc %d\n",
1296 mode->name, fb_crtc->mode_set.crtc->base.id);
1297 fb_crtc->desired_mode = mode;
1299 drm_mode_destroy(dev, modeset->mode);
1300 modeset->mode = drm_mode_duplicate(dev,
1301 fb_crtc->desired_mode);
1302 modeset->connectors[modeset->num_connectors++] = fb_helper->connector_info[i]->connector;
1313 * drm_helper_initial_config - setup a sane initial connector configuration
1314 * @fb_helper: fb_helper device struct
1315 * @bpp_sel: bpp value to use for the framebuffer configuration
1318 * Called at init time by the driver to set up the @fb_helper initial
1319 * configuration, must take the mode config lock.
1321 * Scans the CRTCs and connectors and tries to put together an initial setup.
1322 * At the moment, this is a cloned configuration across all heads with
1323 * a new framebuffer object as the backing store.
1326 * Zero if everything went ok, nonzero otherwise.
1328 bool drm_fb_helper_initial_config(struct drm_fb_helper *fb_helper, int bpp_sel)
1330 struct drm_device *dev = fb_helper->dev;
1333 /* disable all the possible outputs/crtcs before entering KMS mode */
1334 drm_helper_disable_unused_functions(fb_helper->dev);
1336 drm_fb_helper_parse_command_line(fb_helper);
1338 count = drm_fb_helper_probe_connector_modes(fb_helper,
1339 dev->mode_config.max_width,
1340 dev->mode_config.max_height);
1342 * we shouldn't end up with no modes here.
1345 dev_info(fb_helper->dev->dev, "No connectors reported connected with modes\n");
1347 drm_setup_crtcs(fb_helper);
1349 return drm_fb_helper_single_fb_probe(fb_helper, bpp_sel);
1351 EXPORT_SYMBOL(drm_fb_helper_initial_config);
1354 * drm_fb_helper_hotplug_event - respond to a hotplug notification by
1355 * probing all the outputs attached to the fb
1356 * @fb_helper: the drm_fb_helper
1359 * Called at runtime, must take mode config lock.
1361 * Scan the connectors attached to the fb_helper and try to put together a
1362 * setup after *notification of a change in output configuration.
1365 * 0 on success and a non-zero error code otherwise.
1367 int drm_fb_helper_hotplug_event(struct drm_fb_helper *fb_helper)
1369 struct drm_device *dev = fb_helper->dev;
1371 u32 max_width, max_height, bpp_sel;
1372 int bound = 0, crtcs_bound = 0;
1373 struct drm_crtc *crtc;
1378 mutex_lock(&dev->mode_config.mutex);
1379 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
1382 if (crtc->fb == fb_helper->fb)
1386 if (bound < crtcs_bound) {
1387 fb_helper->delayed_hotplug = true;
1388 mutex_unlock(&dev->mode_config.mutex);
1391 DRM_DEBUG_KMS("\n");
1393 max_width = fb_helper->fb->width;
1394 max_height = fb_helper->fb->height;
1395 bpp_sel = fb_helper->fb->bits_per_pixel;
1397 count = drm_fb_helper_probe_connector_modes(fb_helper, max_width,
1399 drm_setup_crtcs(fb_helper);
1400 mutex_unlock(&dev->mode_config.mutex);
1402 return drm_fb_helper_single_fb_probe(fb_helper, bpp_sel);
1404 EXPORT_SYMBOL(drm_fb_helper_hotplug_event);
1406 /* The Kconfig DRM_KMS_HELPER selects FRAMEBUFFER_CONSOLE (if !EXPERT)
1407 * but the module doesn't depend on any fb console symbols. At least
1408 * attempt to load fbcon to avoid leaving the system without a usable console.
1410 #if defined(CONFIG_FRAMEBUFFER_CONSOLE_MODULE) && !defined(CONFIG_EXPERT)
1411 static int __init drm_fb_helper_modinit(void)
1413 const char *name = "fbcon";
1414 struct module *fbcon;
1416 mutex_lock(&module_mutex);
1417 fbcon = find_module(name);
1418 mutex_unlock(&module_mutex);
1421 request_module_nowait(name);
1425 module_init(drm_fb_helper_modinit);