Linux Audio

Check our new training course

Loading...
v3.1
   1/*
   2 * Copyright (c) 2006-2009 Red Hat Inc.
   3 * Copyright (c) 2006-2008 Intel Corporation
   4 * Copyright (c) 2007 Dave Airlie <airlied@linux.ie>
   5 *
   6 * DRM framebuffer helper functions
   7 *
   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.
  17 *
  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
  24 * OF THIS SOFTWARE.
  25 *
  26 * Authors:
  27 *      Dave Airlie <airlied@linux.ie>
  28 *      Jesse Barnes <jesse.barnes@intel.com>
  29 */
 
 
 
  30#include <linux/kernel.h>
  31#include <linux/sysrq.h>
  32#include <linux/slab.h>
  33#include <linux/fb.h>
  34#include "drmP.h"
  35#include "drm_crtc.h"
  36#include "drm_fb_helper.h"
  37#include "drm_crtc_helper.h"
  38
  39MODULE_AUTHOR("David Airlie, Jesse Barnes");
  40MODULE_DESCRIPTION("DRM KMS helper");
  41MODULE_LICENSE("GPL and additional rights");
 
 
 
 
 
  42
  43static LIST_HEAD(kernel_fb_helper_list);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  44
  45/* simple single crtc case helper function */
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  46int drm_fb_helper_single_add_all_connectors(struct drm_fb_helper *fb_helper)
  47{
  48	struct drm_device *dev = fb_helper->dev;
  49	struct drm_connector *connector;
  50	int i;
  51
  52	list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
  53		struct drm_fb_helper_connector *fb_helper_connector;
  54
  55		fb_helper_connector = kzalloc(sizeof(struct drm_fb_helper_connector), GFP_KERNEL);
  56		if (!fb_helper_connector)
  57			goto fail;
  58
  59		fb_helper_connector->connector = connector;
  60		fb_helper->connector_info[fb_helper->connector_count++] = fb_helper_connector;
  61	}
 
  62	return 0;
  63fail:
  64	for (i = 0; i < fb_helper->connector_count; i++) {
  65		kfree(fb_helper->connector_info[i]);
 
 
 
 
 
  66		fb_helper->connector_info[i] = NULL;
  67	}
  68	fb_helper->connector_count = 0;
  69	return -ENOMEM;
 
 
  70}
  71EXPORT_SYMBOL(drm_fb_helper_single_add_all_connectors);
  72
  73static int drm_fb_helper_parse_command_line(struct drm_fb_helper *fb_helper)
  74{
  75	struct drm_fb_helper_connector *fb_helper_conn;
  76	int i;
  77
  78	for (i = 0; i < fb_helper->connector_count; i++) {
  79		struct drm_cmdline_mode *mode;
  80		struct drm_connector *connector;
  81		char *option = NULL;
  82
  83		fb_helper_conn = fb_helper->connector_info[i];
  84		connector = fb_helper_conn->connector;
  85		mode = &fb_helper_conn->cmdline_mode;
 
 
  86
  87		/* do something on return - turn off connector maybe */
  88		if (fb_get_options(drm_get_connector_name(connector), &option))
  89			continue;
  90
  91		if (drm_mode_parse_command_line_for_connector(option,
  92							      connector,
  93							      mode)) {
  94			if (mode->force) {
  95				const char *s;
  96				switch (mode->force) {
  97				case DRM_FORCE_OFF: s = "OFF"; break;
  98				case DRM_FORCE_ON_DIGITAL: s = "ON - dig"; break;
  99				default:
 100				case DRM_FORCE_ON: s = "ON"; break;
 101				}
 102
 103				DRM_INFO("forcing %s connector %s\n",
 104					 drm_get_connector_name(connector), s);
 105				connector->force = mode->force;
 106			}
 107
 108			DRM_DEBUG_KMS("cmdline mode for connector %s %dx%d@%dHz%s%s%s\n",
 109				      drm_get_connector_name(connector),
 110				      mode->xres, mode->yres,
 111				      mode->refresh_specified ? mode->refresh : 60,
 112				      mode->rb ? " reduced blanking" : "",
 113				      mode->margins ? " with margins" : "",
 114				      mode->interlace ?  " interlaced" : "");
 115		}
 
 
 
 
 
 
 
 
 
 
 
 116
 
 
 
 
 
 117	}
 
 
 
 
 
 
 
 
 
 
 
 
 118	return 0;
 119}
 
 120
 121static void drm_fb_helper_save_lut_atomic(struct drm_crtc *crtc, struct drm_fb_helper *helper)
 122{
 123	uint16_t *r_base, *g_base, *b_base;
 124	int i;
 125
 
 
 
 126	r_base = crtc->gamma_store;
 127	g_base = r_base + crtc->gamma_size;
 128	b_base = g_base + crtc->gamma_size;
 129
 130	for (i = 0; i < crtc->gamma_size; i++)
 131		helper->funcs->gamma_get(crtc, &r_base[i], &g_base[i], &b_base[i], i);
 132}
 133
 134static void drm_fb_helper_restore_lut_atomic(struct drm_crtc *crtc)
 135{
 136	uint16_t *r_base, *g_base, *b_base;
 137
 
 
 
 138	r_base = crtc->gamma_store;
 139	g_base = r_base + crtc->gamma_size;
 140	b_base = g_base + crtc->gamma_size;
 141
 142	crtc->funcs->gamma_set(crtc, r_base, g_base, b_base, 0, crtc->gamma_size);
 143}
 144
 
 
 
 
 145int drm_fb_helper_debug_enter(struct fb_info *info)
 146{
 147	struct drm_fb_helper *helper = info->par;
 148	struct drm_crtc_helper_funcs *funcs;
 149	int i;
 150
 151	if (list_empty(&kernel_fb_helper_list))
 152		return false;
 153
 154	list_for_each_entry(helper, &kernel_fb_helper_list, kernel_fb_list) {
 155		for (i = 0; i < helper->crtc_count; i++) {
 156			struct drm_mode_set *mode_set =
 157				&helper->crtc_info[i].mode_set;
 158
 159			if (!mode_set->crtc->enabled)
 160				continue;
 161
 162			funcs =	mode_set->crtc->helper_private;
 
 
 
 163			drm_fb_helper_save_lut_atomic(mode_set->crtc, helper);
 164			funcs->mode_set_base_atomic(mode_set->crtc,
 165						    mode_set->fb,
 166						    mode_set->x,
 167						    mode_set->y,
 168						    ENTER_ATOMIC_MODE_SET);
 169		}
 170	}
 171
 172	return 0;
 173}
 174EXPORT_SYMBOL(drm_fb_helper_debug_enter);
 175
 176/* Find the real fb for a given fb helper CRTC */
 177static struct drm_framebuffer *drm_mode_config_fb(struct drm_crtc *crtc)
 178{
 179	struct drm_device *dev = crtc->dev;
 180	struct drm_crtc *c;
 181
 182	list_for_each_entry(c, &dev->mode_config.crtc_list, head) {
 183		if (crtc->base.id == c->base.id)
 184			return c->fb;
 185	}
 186
 187	return NULL;
 188}
 189
 
 
 
 
 190int drm_fb_helper_debug_leave(struct fb_info *info)
 191{
 192	struct drm_fb_helper *helper = info->par;
 193	struct drm_crtc *crtc;
 194	struct drm_crtc_helper_funcs *funcs;
 195	struct drm_framebuffer *fb;
 196	int i;
 197
 198	for (i = 0; i < helper->crtc_count; i++) {
 199		struct drm_mode_set *mode_set = &helper->crtc_info[i].mode_set;
 200		crtc = mode_set->crtc;
 201		funcs = crtc->helper_private;
 202		fb = drm_mode_config_fb(crtc);
 203
 204		if (!crtc->enabled)
 205			continue;
 206
 207		if (!fb) {
 208			DRM_ERROR("no fb to restore??\n");
 209			continue;
 210		}
 211
 
 
 
 212		drm_fb_helper_restore_lut_atomic(mode_set->crtc);
 213		funcs->mode_set_base_atomic(mode_set->crtc, fb, crtc->x,
 214					    crtc->y, LEAVE_ATOMIC_MODE_SET);
 215	}
 216
 217	return 0;
 218}
 219EXPORT_SYMBOL(drm_fb_helper_debug_leave);
 220
 221bool drm_fb_helper_restore_fbdev_mode(struct drm_fb_helper *fb_helper)
 222{
 223	bool error = false;
 
 
 224	int i, ret;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 225	for (i = 0; i < fb_helper->crtc_count; i++) {
 226		struct drm_mode_set *mode_set = &fb_helper->crtc_info[i].mode_set;
 227		ret = drm_crtc_helper_set_config(mode_set);
 
 
 
 
 
 
 
 
 
 
 
 
 
 228		if (ret)
 229			error = true;
 230	}
 231	return error;
 
 232}
 233EXPORT_SYMBOL(drm_fb_helper_restore_fbdev_mode);
 234
 235bool drm_fb_helper_force_kernel_mode(void)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 236{
 237	bool ret, error = false;
 238	struct drm_fb_helper *helper;
 239
 240	if (list_empty(&kernel_fb_helper_list))
 241		return false;
 242
 243	list_for_each_entry(helper, &kernel_fb_helper_list, kernel_fb_list) {
 244		if (helper->dev->switch_power_state == DRM_SWITCH_POWER_OFF)
 
 
 245			continue;
 246
 247		ret = drm_fb_helper_restore_fbdev_mode(helper);
 
 248		if (ret)
 249			error = true;
 
 250	}
 251	return error;
 252}
 253
 254int drm_fb_helper_panic(struct notifier_block *n, unsigned long ununsed,
 255			void *panic_str)
 256{
 257	printk(KERN_ERR "panic occurred, switching back to text console\n");
 258	return drm_fb_helper_force_kernel_mode();
 259}
 260EXPORT_SYMBOL(drm_fb_helper_panic);
 261
 262static struct notifier_block paniced = {
 263	.notifier_call = drm_fb_helper_panic,
 264};
 265
 266/**
 267 * drm_fb_helper_restore - restore the framebuffer console (kernel) config
 268 *
 269 * Restore's the kernel's fbcon mode, used for lastclose & panic paths.
 270 */
 271void drm_fb_helper_restore(void)
 272{
 273	bool ret;
 274	ret = drm_fb_helper_force_kernel_mode();
 275	if (ret == true)
 276		DRM_ERROR("Failed to restore crtc configuration\n");
 277}
 278EXPORT_SYMBOL(drm_fb_helper_restore);
 279
 280#ifdef CONFIG_MAGIC_SYSRQ
 281static void drm_fb_helper_restore_work_fn(struct work_struct *ignored)
 282{
 283	drm_fb_helper_restore();
 284}
 285static DECLARE_WORK(drm_fb_helper_restore_work, drm_fb_helper_restore_work_fn);
 286
 287static void drm_fb_helper_sysrq(int dummy1)
 288{
 289	schedule_work(&drm_fb_helper_restore_work);
 290}
 291
 292static struct sysrq_key_op sysrq_drm_fb_helper_restore_op = {
 293	.handler = drm_fb_helper_sysrq,
 294	.help_msg = "force-fb(V)",
 295	.action_msg = "Restore framebuffer console",
 296};
 297#else
 298static struct sysrq_key_op sysrq_drm_fb_helper_restore_op = { };
 299#endif
 300
 301static void drm_fb_helper_on(struct fb_info *info)
 302{
 303	struct drm_fb_helper *fb_helper = info->par;
 304	struct drm_device *dev = fb_helper->dev;
 305	struct drm_crtc *crtc;
 306	struct drm_crtc_helper_funcs *crtc_funcs;
 307	struct drm_connector *connector;
 308	struct drm_encoder *encoder;
 309	int i, j;
 310
 311	/*
 312	 * For each CRTC in this fb, turn the crtc on then,
 313	 * find all associated encoders and turn them on.
 314	 */
 315	mutex_lock(&dev->mode_config.mutex);
 316	for (i = 0; i < fb_helper->crtc_count; i++) {
 317		crtc = fb_helper->crtc_info[i].mode_set.crtc;
 318		crtc_funcs = crtc->helper_private;
 319
 320		if (!crtc->enabled)
 321			continue;
 322
 323		crtc_funcs->dpms(crtc, DRM_MODE_DPMS_ON);
 324
 325		/* Walk the connectors & encoders on this fb turning them on */
 326		for (j = 0; j < fb_helper->connector_count; j++) {
 327			connector = fb_helper->connector_info[j]->connector;
 328			connector->dpms = DRM_MODE_DPMS_ON;
 329			drm_connector_property_set_value(connector,
 330							 dev->mode_config.dpms_property,
 331							 DRM_MODE_DPMS_ON);
 332		}
 333		/* Found a CRTC on this fb, now find encoders */
 334		list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
 335			if (encoder->crtc == crtc) {
 336				struct drm_encoder_helper_funcs *encoder_funcs;
 337
 338				encoder_funcs = encoder->helper_private;
 339				encoder_funcs->dpms(encoder, DRM_MODE_DPMS_ON);
 340			}
 341		}
 342	}
 343	mutex_unlock(&dev->mode_config.mutex);
 344}
 345
 346static void drm_fb_helper_off(struct fb_info *info, int dpms_mode)
 347{
 348	struct drm_fb_helper *fb_helper = info->par;
 349	struct drm_device *dev = fb_helper->dev;
 350	struct drm_crtc *crtc;
 351	struct drm_crtc_helper_funcs *crtc_funcs;
 352	struct drm_connector *connector;
 353	struct drm_encoder *encoder;
 354	int i, j;
 355
 356	/*
 357	 * For each CRTC in this fb, find all associated encoders
 358	 * and turn them off, then turn off the CRTC.
 359	 */
 360	mutex_lock(&dev->mode_config.mutex);
 361	for (i = 0; i < fb_helper->crtc_count; i++) {
 362		crtc = fb_helper->crtc_info[i].mode_set.crtc;
 363		crtc_funcs = crtc->helper_private;
 364
 365		if (!crtc->enabled)
 366			continue;
 367
 368		/* Walk the connectors on this fb and mark them off */
 369		for (j = 0; j < fb_helper->connector_count; j++) {
 370			connector = fb_helper->connector_info[j]->connector;
 371			connector->dpms = dpms_mode;
 372			drm_connector_property_set_value(connector,
 373							 dev->mode_config.dpms_property,
 374							 dpms_mode);
 375		}
 376		/* Found a CRTC on this fb, now find encoders */
 377		list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
 378			if (encoder->crtc == crtc) {
 379				struct drm_encoder_helper_funcs *encoder_funcs;
 380
 381				encoder_funcs = encoder->helper_private;
 382				encoder_funcs->dpms(encoder, dpms_mode);
 383			}
 384		}
 385		crtc_funcs->dpms(crtc, DRM_MODE_DPMS_OFF);
 386	}
 387	mutex_unlock(&dev->mode_config.mutex);
 388}
 389
 
 
 
 
 
 390int drm_fb_helper_blank(int blank, struct fb_info *info)
 391{
 
 
 
 392	switch (blank) {
 393	/* Display: On; HSync: On, VSync: On */
 394	case FB_BLANK_UNBLANK:
 395		drm_fb_helper_on(info);
 396		break;
 397	/* Display: Off; HSync: On, VSync: On */
 398	case FB_BLANK_NORMAL:
 399		drm_fb_helper_off(info, DRM_MODE_DPMS_STANDBY);
 400		break;
 401	/* Display: Off; HSync: Off, VSync: On */
 402	case FB_BLANK_HSYNC_SUSPEND:
 403		drm_fb_helper_off(info, DRM_MODE_DPMS_STANDBY);
 404		break;
 405	/* Display: Off; HSync: On, VSync: Off */
 406	case FB_BLANK_VSYNC_SUSPEND:
 407		drm_fb_helper_off(info, DRM_MODE_DPMS_SUSPEND);
 408		break;
 409	/* Display: Off; HSync: Off, VSync: Off */
 410	case FB_BLANK_POWERDOWN:
 411		drm_fb_helper_off(info, DRM_MODE_DPMS_OFF);
 412		break;
 413	}
 414	return 0;
 415}
 416EXPORT_SYMBOL(drm_fb_helper_blank);
 417
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 418static void drm_fb_helper_crtc_free(struct drm_fb_helper *helper)
 419{
 420	int i;
 421
 422	for (i = 0; i < helper->connector_count; i++)
 
 423		kfree(helper->connector_info[i]);
 
 424	kfree(helper->connector_info);
 425	for (i = 0; i < helper->crtc_count; i++)
 426		kfree(helper->crtc_info[i].mode_set.connectors);
 
 
 
 
 
 427	kfree(helper->crtc_info);
 428}
 429
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 430int drm_fb_helper_init(struct drm_device *dev,
 431		       struct drm_fb_helper *fb_helper,
 432		       int crtc_count, int max_conn_count)
 433{
 434	struct drm_crtc *crtc;
 435	int ret = 0;
 436	int i;
 437
 438	fb_helper->dev = dev;
 
 439
 440	INIT_LIST_HEAD(&fb_helper->kernel_fb_list);
 
 441
 442	fb_helper->crtc_info = kcalloc(crtc_count, sizeof(struct drm_fb_helper_crtc), GFP_KERNEL);
 443	if (!fb_helper->crtc_info)
 444		return -ENOMEM;
 445
 446	fb_helper->crtc_count = crtc_count;
 447	fb_helper->connector_info = kcalloc(dev->mode_config.num_connector, sizeof(struct drm_fb_helper_connector *), GFP_KERNEL);
 448	if (!fb_helper->connector_info) {
 449		kfree(fb_helper->crtc_info);
 450		return -ENOMEM;
 451	}
 
 452	fb_helper->connector_count = 0;
 453
 454	for (i = 0; i < crtc_count; i++) {
 455		fb_helper->crtc_info[i].mode_set.connectors =
 456			kcalloc(max_conn_count,
 457				sizeof(struct drm_connector *),
 458				GFP_KERNEL);
 459
 460		if (!fb_helper->crtc_info[i].mode_set.connectors) {
 461			ret = -ENOMEM;
 462			goto out_free;
 463		}
 464		fb_helper->crtc_info[i].mode_set.num_connectors = 0;
 465	}
 466
 467	i = 0;
 468	list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
 469		fb_helper->crtc_info[i].crtc_id = crtc->base.id;
 470		fb_helper->crtc_info[i].mode_set.crtc = crtc;
 471		i++;
 472	}
 473	fb_helper->conn_limit = max_conn_count;
 474	return 0;
 475out_free:
 476	drm_fb_helper_crtc_free(fb_helper);
 477	return -ENOMEM;
 478}
 479EXPORT_SYMBOL(drm_fb_helper_init);
 480
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 481void drm_fb_helper_fini(struct drm_fb_helper *fb_helper)
 482{
 
 
 
 
 
 
 
 483	if (!list_empty(&fb_helper->kernel_fb_list)) {
 484		list_del(&fb_helper->kernel_fb_list);
 485		if (list_empty(&kernel_fb_helper_list)) {
 486			printk(KERN_INFO "drm: unregistered panic notifier\n");
 487			atomic_notifier_chain_unregister(&panic_notifier_list,
 488							 &paniced);
 489			unregister_sysrq_key('v', &sysrq_drm_fb_helper_restore_op);
 490		}
 491	}
 
 492
 493	drm_fb_helper_crtc_free(fb_helper);
 494
 495}
 496EXPORT_SYMBOL(drm_fb_helper_fini);
 497
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 498static int setcolreg(struct drm_crtc *crtc, u16 red, u16 green,
 499		     u16 blue, u16 regno, struct fb_info *info)
 500{
 501	struct drm_fb_helper *fb_helper = info->par;
 502	struct drm_framebuffer *fb = fb_helper->fb;
 503	int pindex;
 504
 505	if (info->fix.visual == FB_VISUAL_TRUECOLOR) {
 506		u32 *palette;
 507		u32 value;
 508		/* place color in psuedopalette */
 509		if (regno > 16)
 510			return -EINVAL;
 511		palette = (u32 *)info->pseudo_palette;
 512		red >>= (16 - info->var.red.length);
 513		green >>= (16 - info->var.green.length);
 514		blue >>= (16 - info->var.blue.length);
 515		value = (red << info->var.red.offset) |
 516			(green << info->var.green.offset) |
 517			(blue << info->var.blue.offset);
 518		if (info->var.transp.length > 0) {
 519			u32 mask = (1 << info->var.transp.length) - 1;
 520			mask <<= info->var.transp.offset;
 521			value |= mask;
 522		}
 523		palette[regno] = value;
 524		return 0;
 525	}
 526
 527	pindex = regno;
 528
 529	if (fb->bits_per_pixel == 16) {
 530		pindex = regno << 3;
 531
 532		if (fb->depth == 16 && regno > 63)
 533			return -EINVAL;
 534		if (fb->depth == 15 && regno > 31)
 535			return -EINVAL;
 536
 537		if (fb->depth == 16) {
 538			u16 r, g, b;
 539			int i;
 540			if (regno < 32) {
 541				for (i = 0; i < 8; i++)
 542					fb_helper->funcs->gamma_set(crtc, red,
 543						green, blue, pindex + i);
 544			}
 545
 546			fb_helper->funcs->gamma_get(crtc, &r,
 547						    &g, &b,
 548						    pindex >> 1);
 549
 550			for (i = 0; i < 4; i++)
 551				fb_helper->funcs->gamma_set(crtc, r,
 552							    green, b,
 553							    (pindex >> 1) + i);
 554		}
 555	}
 556
 557	if (fb->depth != 16)
 558		fb_helper->funcs->gamma_set(crtc, red, green, blue, pindex);
 559	return 0;
 560}
 561
 
 
 
 
 
 562int drm_fb_helper_setcmap(struct fb_cmap *cmap, struct fb_info *info)
 563{
 564	struct drm_fb_helper *fb_helper = info->par;
 565	struct drm_crtc_helper_funcs *crtc_funcs;
 
 566	u16 *red, *green, *blue, *transp;
 567	struct drm_crtc *crtc;
 568	int i, j, rc = 0;
 569	int start;
 570
 
 
 
 
 
 
 
 
 
 571	for (i = 0; i < fb_helper->crtc_count; i++) {
 572		crtc = fb_helper->crtc_info[i].mode_set.crtc;
 573		crtc_funcs = crtc->helper_private;
 574
 575		red = cmap->red;
 576		green = cmap->green;
 577		blue = cmap->blue;
 578		transp = cmap->transp;
 579		start = cmap->start;
 580
 581		for (j = 0; j < cmap->len; j++) {
 582			u16 hred, hgreen, hblue, htransp = 0xffff;
 583
 584			hred = *red++;
 585			hgreen = *green++;
 586			hblue = *blue++;
 587
 588			if (transp)
 589				htransp = *transp++;
 590
 591			rc = setcolreg(crtc, hred, hgreen, hblue, start++, info);
 592			if (rc)
 593				return rc;
 594		}
 595		crtc_funcs->load_lut(crtc);
 
 596	}
 
 
 597	return rc;
 598}
 599EXPORT_SYMBOL(drm_fb_helper_setcmap);
 600
 
 
 
 
 
 601int drm_fb_helper_check_var(struct fb_var_screeninfo *var,
 602			    struct fb_info *info)
 603{
 604	struct drm_fb_helper *fb_helper = info->par;
 605	struct drm_framebuffer *fb = fb_helper->fb;
 606	int depth;
 607
 608	if (var->pixclock != 0 || in_dbg_master())
 609		return -EINVAL;
 610
 611	/* Need to resize the fb object !!! */
 612	if (var->bits_per_pixel > fb->bits_per_pixel || var->xres > fb->width || var->yres > fb->height) {
 613		DRM_DEBUG("fb userspace requested width/height/bpp is greater than current fb "
 614			  "object %dx%d-%d > %dx%d-%d\n", var->xres, var->yres, var->bits_per_pixel,
 
 
 
 
 
 
 
 615			  fb->width, fb->height, fb->bits_per_pixel);
 616		return -EINVAL;
 617	}
 618
 619	switch (var->bits_per_pixel) {
 620	case 16:
 621		depth = (var->green.length == 6) ? 16 : 15;
 622		break;
 623	case 32:
 624		depth = (var->transp.length > 0) ? 32 : 24;
 625		break;
 626	default:
 627		depth = var->bits_per_pixel;
 628		break;
 629	}
 630
 631	switch (depth) {
 632	case 8:
 633		var->red.offset = 0;
 634		var->green.offset = 0;
 635		var->blue.offset = 0;
 636		var->red.length = 8;
 637		var->green.length = 8;
 638		var->blue.length = 8;
 639		var->transp.length = 0;
 640		var->transp.offset = 0;
 641		break;
 642	case 15:
 643		var->red.offset = 10;
 644		var->green.offset = 5;
 645		var->blue.offset = 0;
 646		var->red.length = 5;
 647		var->green.length = 5;
 648		var->blue.length = 5;
 649		var->transp.length = 1;
 650		var->transp.offset = 15;
 651		break;
 652	case 16:
 653		var->red.offset = 11;
 654		var->green.offset = 5;
 655		var->blue.offset = 0;
 656		var->red.length = 5;
 657		var->green.length = 6;
 658		var->blue.length = 5;
 659		var->transp.length = 0;
 660		var->transp.offset = 0;
 661		break;
 662	case 24:
 663		var->red.offset = 16;
 664		var->green.offset = 8;
 665		var->blue.offset = 0;
 666		var->red.length = 8;
 667		var->green.length = 8;
 668		var->blue.length = 8;
 669		var->transp.length = 0;
 670		var->transp.offset = 0;
 671		break;
 672	case 32:
 673		var->red.offset = 16;
 674		var->green.offset = 8;
 675		var->blue.offset = 0;
 676		var->red.length = 8;
 677		var->green.length = 8;
 678		var->blue.length = 8;
 679		var->transp.length = 8;
 680		var->transp.offset = 24;
 681		break;
 682	default:
 683		return -EINVAL;
 684	}
 685	return 0;
 686}
 687EXPORT_SYMBOL(drm_fb_helper_check_var);
 688
 689/* this will let fbcon do the mode init */
 
 
 
 
 
 
 
 690int drm_fb_helper_set_par(struct fb_info *info)
 691{
 692	struct drm_fb_helper *fb_helper = info->par;
 693	struct drm_device *dev = fb_helper->dev;
 694	struct fb_var_screeninfo *var = &info->var;
 695	struct drm_crtc *crtc;
 696	int ret;
 697	int i;
 698
 699	if (var->pixclock != 0) {
 700		DRM_ERROR("PIXEL CLOCK SET\n");
 701		return -EINVAL;
 702	}
 703
 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;
 707		ret = crtc->funcs->set_config(&fb_helper->crtc_info[i].mode_set);
 708		if (ret) {
 709			mutex_unlock(&dev->mode_config.mutex);
 710			return ret;
 711		}
 712	}
 713	mutex_unlock(&dev->mode_config.mutex);
 714
 715	if (fb_helper->delayed_hotplug) {
 716		fb_helper->delayed_hotplug = false;
 717		drm_fb_helper_hotplug_event(fb_helper);
 718	}
 719	return 0;
 720}
 721EXPORT_SYMBOL(drm_fb_helper_set_par);
 722
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 723int drm_fb_helper_pan_display(struct fb_var_screeninfo *var,
 724			      struct fb_info *info)
 725{
 726	struct drm_fb_helper *fb_helper = info->par;
 727	struct drm_device *dev = fb_helper->dev;
 728	struct drm_mode_set *modeset;
 729	struct drm_crtc *crtc;
 730	int ret = 0;
 731	int i;
 732
 733	mutex_lock(&dev->mode_config.mutex);
 734	for (i = 0; i < fb_helper->crtc_count; i++) {
 735		crtc = fb_helper->crtc_info[i].mode_set.crtc;
 
 
 
 
 
 736
 
 
 
 
 
 
 737		modeset = &fb_helper->crtc_info[i].mode_set;
 738
 739		modeset->x = var->xoffset;
 740		modeset->y = var->yoffset;
 741
 742		if (modeset->num_connectors) {
 743			ret = crtc->funcs->set_config(modeset);
 744			if (!ret) {
 745				info->var.xoffset = var->xoffset;
 746				info->var.yoffset = var->yoffset;
 747			}
 748		}
 749	}
 750	mutex_unlock(&dev->mode_config.mutex);
 
 751	return ret;
 752}
 753EXPORT_SYMBOL(drm_fb_helper_pan_display);
 754
 755int drm_fb_helper_single_fb_probe(struct drm_fb_helper *fb_helper,
 756				  int preferred_bpp)
 
 
 
 
 
 757{
 758	int new_fb = 0;
 759	int crtc_count = 0;
 760	int i;
 761	struct fb_info *info;
 762	struct drm_fb_helper_surface_size sizes;
 763	int gamma_size = 0;
 764
 765	memset(&sizes, 0, sizeof(struct drm_fb_helper_surface_size));
 766	sizes.surface_depth = 24;
 767	sizes.surface_bpp = 32;
 768	sizes.fb_width = (unsigned)-1;
 769	sizes.fb_height = (unsigned)-1;
 770
 771	/* if driver picks 8 or 16 by default use that
 772	   for both depth/bpp */
 773	if (preferred_bpp != sizes.surface_bpp) {
 774		sizes.surface_depth = sizes.surface_bpp = preferred_bpp;
 775	}
 776	/* first up get a count of crtcs now in use and new min/maxes width/heights */
 777	for (i = 0; i < fb_helper->connector_count; i++) {
 778		struct drm_fb_helper_connector *fb_helper_conn = fb_helper->connector_info[i];
 779		struct drm_cmdline_mode *cmdline_mode;
 780
 781		cmdline_mode = &fb_helper_conn->cmdline_mode;
 782
 783		if (cmdline_mode->bpp_specified) {
 784			switch (cmdline_mode->bpp) {
 785			case 8:
 786				sizes.surface_depth = sizes.surface_bpp = 8;
 787				break;
 788			case 15:
 789				sizes.surface_depth = 15;
 790				sizes.surface_bpp = 16;
 791				break;
 792			case 16:
 793				sizes.surface_depth = sizes.surface_bpp = 16;
 794				break;
 795			case 24:
 796				sizes.surface_depth = sizes.surface_bpp = 24;
 797				break;
 798			case 32:
 799				sizes.surface_depth = 24;
 800				sizes.surface_bpp = 32;
 801				break;
 802			}
 803			break;
 804		}
 805	}
 806
 807	crtc_count = 0;
 808	for (i = 0; i < fb_helper->crtc_count; i++) {
 809		struct drm_display_mode *desired_mode;
 
 
 
 
 
 
 
 
 810		desired_mode = fb_helper->crtc_info[i].desired_mode;
 
 
 
 
 
 
 811
 812		if (desired_mode) {
 813			if (gamma_size == 0)
 814				gamma_size = fb_helper->crtc_info[i].mode_set.crtc->gamma_size;
 815			if (desired_mode->hdisplay < sizes.fb_width)
 816				sizes.fb_width = desired_mode->hdisplay;
 817			if (desired_mode->vdisplay < sizes.fb_height)
 818				sizes.fb_height = desired_mode->vdisplay;
 819			if (desired_mode->hdisplay > sizes.surface_width)
 820				sizes.surface_width = desired_mode->hdisplay;
 821			if (desired_mode->vdisplay > sizes.surface_height)
 822				sizes.surface_height = desired_mode->vdisplay;
 823			crtc_count++;
 
 
 
 
 
 824		}
 
 
 
 
 
 825	}
 826
 827	if (crtc_count == 0 || sizes.fb_width == -1 || sizes.fb_height == -1) {
 828		/* hmm everyone went away - assume VGA cable just fell out
 829		   and will come back later. */
 830		DRM_INFO("Cannot find any crtc or sizes - going 1024x768\n");
 831		sizes.fb_width = sizes.surface_width = 1024;
 832		sizes.fb_height = sizes.surface_height = 768;
 833	}
 834
 835	/* push down into drivers */
 836	new_fb = (*fb_helper->funcs->fb_probe)(fb_helper, &sizes);
 837	if (new_fb < 0)
 838		return new_fb;
 839
 840	info = fb_helper->fbdev;
 841
 842	/* set the fb pointer */
 843	for (i = 0; i < fb_helper->crtc_count; i++) {
 844		fb_helper->crtc_info[i].mode_set.fb = fb_helper->fb;
 845	}
 846
 847	if (new_fb) {
 848		info->var.pixclock = 0;
 849		if (register_framebuffer(info) < 0) {
 850			return -EINVAL;
 851		}
 852
 853		printk(KERN_INFO "fb%d: %s frame buffer device\n", info->node,
 854		       info->fix.id);
 855
 856	} else {
 857		drm_fb_helper_set_par(info);
 858	}
 859
 860	/* Switch back to kernel console on panic */
 861	/* multi card linked list maybe */
 862	if (list_empty(&kernel_fb_helper_list)) {
 863		printk(KERN_INFO "drm: registered panic notifier\n");
 864		atomic_notifier_chain_register(&panic_notifier_list,
 865					       &paniced);
 866		register_sysrq_key('v', &sysrq_drm_fb_helper_restore_op);
 867	}
 868	if (new_fb)
 869		list_add(&fb_helper->kernel_fb_list, &kernel_fb_helper_list);
 870
 871	return 0;
 872}
 873EXPORT_SYMBOL(drm_fb_helper_single_fb_probe);
 874
 
 
 
 
 
 
 
 
 
 
 
 
 
 875void drm_fb_helper_fill_fix(struct fb_info *info, uint32_t pitch,
 876			    uint32_t depth)
 877{
 878	info->fix.type = FB_TYPE_PACKED_PIXELS;
 879	info->fix.visual = depth == 8 ? FB_VISUAL_PSEUDOCOLOR :
 880		FB_VISUAL_TRUECOLOR;
 881	info->fix.mmio_start = 0;
 882	info->fix.mmio_len = 0;
 883	info->fix.type_aux = 0;
 884	info->fix.xpanstep = 1; /* doing it in hw */
 885	info->fix.ypanstep = 1; /* doing it in hw */
 886	info->fix.ywrapstep = 0;
 887	info->fix.accel = FB_ACCEL_NONE;
 888	info->fix.type_aux = 0;
 889
 890	info->fix.line_length = pitch;
 891	return;
 892}
 893EXPORT_SYMBOL(drm_fb_helper_fill_fix);
 894
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 895void drm_fb_helper_fill_var(struct fb_info *info, struct drm_fb_helper *fb_helper,
 896			    uint32_t fb_width, uint32_t fb_height)
 897{
 898	struct drm_framebuffer *fb = fb_helper->fb;
 899	info->pseudo_palette = fb_helper->pseudo_palette;
 900	info->var.xres_virtual = fb->width;
 901	info->var.yres_virtual = fb->height;
 902	info->var.bits_per_pixel = fb->bits_per_pixel;
 903	info->var.accel_flags = FB_ACCELF_TEXT;
 904	info->var.xoffset = 0;
 905	info->var.yoffset = 0;
 906	info->var.activate = FB_ACTIVATE_NOW;
 907	info->var.height = -1;
 908	info->var.width = -1;
 909
 910	switch (fb->depth) {
 911	case 8:
 912		info->var.red.offset = 0;
 913		info->var.green.offset = 0;
 914		info->var.blue.offset = 0;
 915		info->var.red.length = 8; /* 8bit DAC */
 916		info->var.green.length = 8;
 917		info->var.blue.length = 8;
 918		info->var.transp.offset = 0;
 919		info->var.transp.length = 0;
 920		break;
 921	case 15:
 922		info->var.red.offset = 10;
 923		info->var.green.offset = 5;
 924		info->var.blue.offset = 0;
 925		info->var.red.length = 5;
 926		info->var.green.length = 5;
 927		info->var.blue.length = 5;
 928		info->var.transp.offset = 15;
 929		info->var.transp.length = 1;
 930		break;
 931	case 16:
 932		info->var.red.offset = 11;
 933		info->var.green.offset = 5;
 934		info->var.blue.offset = 0;
 935		info->var.red.length = 5;
 936		info->var.green.length = 6;
 937		info->var.blue.length = 5;
 938		info->var.transp.offset = 0;
 939		break;
 940	case 24:
 941		info->var.red.offset = 16;
 942		info->var.green.offset = 8;
 943		info->var.blue.offset = 0;
 944		info->var.red.length = 8;
 945		info->var.green.length = 8;
 946		info->var.blue.length = 8;
 947		info->var.transp.offset = 0;
 948		info->var.transp.length = 0;
 949		break;
 950	case 32:
 951		info->var.red.offset = 16;
 952		info->var.green.offset = 8;
 953		info->var.blue.offset = 0;
 954		info->var.red.length = 8;
 955		info->var.green.length = 8;
 956		info->var.blue.length = 8;
 957		info->var.transp.offset = 24;
 958		info->var.transp.length = 8;
 959		break;
 960	default:
 961		break;
 962	}
 963
 964	info->var.xres = fb_width;
 965	info->var.yres = fb_height;
 966}
 967EXPORT_SYMBOL(drm_fb_helper_fill_var);
 968
 969static int drm_fb_helper_probe_connector_modes(struct drm_fb_helper *fb_helper,
 970					       uint32_t maxX,
 971					       uint32_t maxY)
 972{
 973	struct drm_connector *connector;
 974	int count = 0;
 975	int i;
 976
 977	for (i = 0; i < fb_helper->connector_count; i++) {
 978		connector = fb_helper->connector_info[i]->connector;
 979		count += connector->funcs->fill_modes(connector, maxX, maxY);
 980	}
 981
 982	return count;
 983}
 984
 985static struct drm_display_mode *drm_has_preferred_mode(struct drm_fb_helper_connector *fb_connector, int width, int height)
 986{
 987	struct drm_display_mode *mode;
 988
 989	list_for_each_entry(mode, &fb_connector->connector->modes, head) {
 990		if (drm_mode_width(mode) > width ||
 991		    drm_mode_height(mode) > height)
 992			continue;
 993		if (mode->type & DRM_MODE_TYPE_PREFERRED)
 994			return mode;
 995	}
 996	return NULL;
 997}
 
 998
 999static bool drm_has_cmdline_mode(struct drm_fb_helper_connector *fb_connector)
1000{
1001	struct drm_cmdline_mode *cmdline_mode;
1002	cmdline_mode = &fb_connector->cmdline_mode;
1003	return cmdline_mode->specified;
1004}
1005
1006static struct drm_display_mode *drm_pick_cmdline_mode(struct drm_fb_helper_connector *fb_helper_conn,
1007						      int width, int height)
1008{
1009	struct drm_cmdline_mode *cmdline_mode;
1010	struct drm_display_mode *mode = NULL;
 
1011
1012	cmdline_mode = &fb_helper_conn->cmdline_mode;
1013	if (cmdline_mode->specified == false)
1014		return mode;
1015
1016	/* attempt to find a matching mode in the list of modes
1017	 *  we have gotten so far, if not add a CVT mode that conforms
1018	 */
1019	if (cmdline_mode->rb || cmdline_mode->margins)
1020		goto create_mode;
1021
 
 
1022	list_for_each_entry(mode, &fb_helper_conn->connector->modes, head) {
1023		/* check width/height */
1024		if (mode->hdisplay != cmdline_mode->xres ||
1025		    mode->vdisplay != cmdline_mode->yres)
1026			continue;
1027
1028		if (cmdline_mode->refresh_specified) {
1029			if (mode->vrefresh != cmdline_mode->refresh)
1030				continue;
1031		}
1032
1033		if (cmdline_mode->interlace) {
1034			if (!(mode->flags & DRM_MODE_FLAG_INTERLACE))
1035				continue;
 
 
 
1036		}
1037		return mode;
1038	}
1039
 
 
 
 
 
1040create_mode:
1041	mode = drm_mode_create_from_cmdline_mode(fb_helper_conn->connector->dev,
1042						 cmdline_mode);
1043	list_add(&mode->head, &fb_helper_conn->connector->modes);
1044	return mode;
1045}
 
1046
1047static bool drm_connector_enabled(struct drm_connector *connector, bool strict)
1048{
1049	bool enable;
1050
1051	if (strict) {
1052		enable = connector->status == connector_status_connected;
1053	} else {
1054		enable = connector->status != connector_status_disconnected;
1055	}
1056	return enable;
1057}
1058
1059static void drm_enable_connectors(struct drm_fb_helper *fb_helper,
1060				  bool *enabled)
1061{
1062	bool any_enabled = false;
1063	struct drm_connector *connector;
1064	int i = 0;
1065
1066	for (i = 0; i < fb_helper->connector_count; i++) {
1067		connector = fb_helper->connector_info[i]->connector;
1068		enabled[i] = drm_connector_enabled(connector, true);
1069		DRM_DEBUG_KMS("connector %d enabled? %s\n", connector->base.id,
1070			  enabled[i] ? "yes" : "no");
1071		any_enabled |= enabled[i];
1072	}
1073
1074	if (any_enabled)
1075		return;
1076
1077	for (i = 0; i < fb_helper->connector_count; i++) {
1078		connector = fb_helper->connector_info[i]->connector;
1079		enabled[i] = drm_connector_enabled(connector, false);
1080	}
1081}
1082
1083static bool drm_target_cloned(struct drm_fb_helper *fb_helper,
1084			      struct drm_display_mode **modes,
 
1085			      bool *enabled, int width, int height)
1086{
1087	int count, i, j;
1088	bool can_clone = false;
1089	struct drm_fb_helper_connector *fb_helper_conn;
1090	struct drm_display_mode *dmt_mode, *mode;
1091
1092	/* only contemplate cloning in the single crtc case */
1093	if (fb_helper->crtc_count > 1)
1094		return false;
1095
1096	count = 0;
1097	for (i = 0; i < fb_helper->connector_count; i++) {
1098		if (enabled[i])
1099			count++;
1100	}
1101
1102	/* only contemplate cloning if more than one connector is enabled */
1103	if (count <= 1)
1104		return false;
1105
1106	/* check the command line or if nothing common pick 1024x768 */
1107	can_clone = true;
1108	for (i = 0; i < fb_helper->connector_count; i++) {
1109		if (!enabled[i])
1110			continue;
1111		fb_helper_conn = fb_helper->connector_info[i];
1112		modes[i] = drm_pick_cmdline_mode(fb_helper_conn, width, height);
1113		if (!modes[i]) {
1114			can_clone = false;
1115			break;
1116		}
1117		for (j = 0; j < i; j++) {
1118			if (!enabled[j])
1119				continue;
1120			if (!drm_mode_equal(modes[j], modes[i]))
1121				can_clone = false;
1122		}
1123	}
1124
1125	if (can_clone) {
1126		DRM_DEBUG_KMS("can clone using command line\n");
1127		return true;
1128	}
1129
1130	/* try and find a 1024x768 mode on each connector */
1131	can_clone = true;
1132	dmt_mode = drm_mode_find_dmt(fb_helper->dev, 1024, 768, 60);
1133
1134	for (i = 0; i < fb_helper->connector_count; i++) {
1135
 
1136		if (!enabled[i])
1137			continue;
1138
1139		fb_helper_conn = fb_helper->connector_info[i];
1140		list_for_each_entry(mode, &fb_helper_conn->connector->modes, head) {
1141			if (drm_mode_equal(mode, dmt_mode))
1142				modes[i] = mode;
1143		}
1144		if (!modes[i])
1145			can_clone = false;
1146	}
1147
1148	if (can_clone) {
1149		DRM_DEBUG_KMS("can clone using 1024x768\n");
1150		return true;
1151	}
1152	DRM_INFO("kms: can't enable cloning when we probably wanted to.\n");
1153	return false;
1154}
1155
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1156static bool drm_target_preferred(struct drm_fb_helper *fb_helper,
1157				 struct drm_display_mode **modes,
 
1158				 bool *enabled, int width, int height)
1159{
1160	struct drm_fb_helper_connector *fb_helper_conn;
 
 
 
1161	int i;
1162
1163	for (i = 0; i < fb_helper->connector_count; i++) {
 
1164		fb_helper_conn = fb_helper->connector_info[i];
1165
1166		if (enabled[i] == false)
 
 
 
 
1167			continue;
 
 
 
 
 
 
 
 
 
 
1168
 
 
 
 
 
 
 
 
 
 
 
1169		DRM_DEBUG_KMS("looking for cmdline mode on connector %d\n",
1170			      fb_helper_conn->connector->base.id);
1171
1172		/* got for command line mode first */
1173		modes[i] = drm_pick_cmdline_mode(fb_helper_conn, width, height);
1174		if (!modes[i]) {
1175			DRM_DEBUG_KMS("looking for preferred mode on connector %d\n",
1176				      fb_helper_conn->connector->base.id);
1177			modes[i] = drm_has_preferred_mode(fb_helper_conn, width, height);
1178		}
1179		/* No preferred modes, pick one off the list */
1180		if (!modes[i] && !list_empty(&fb_helper_conn->connector->modes)) {
1181			list_for_each_entry(modes[i], &fb_helper_conn->connector->modes, head)
1182				break;
1183		}
1184		DRM_DEBUG_KMS("found mode %s\n", modes[i] ? modes[i]->name :
1185			  "none");
 
 
 
 
 
 
1186	}
1187	return true;
1188}
1189
1190static int drm_pick_crtcs(struct drm_fb_helper *fb_helper,
1191			  struct drm_fb_helper_crtc **best_crtcs,
1192			  struct drm_display_mode **modes,
1193			  int n, int width, int height)
1194{
1195	int c, o;
1196	struct drm_device *dev = fb_helper->dev;
1197	struct drm_connector *connector;
1198	struct drm_connector_helper_funcs *connector_funcs;
1199	struct drm_encoder *encoder;
1200	struct drm_fb_helper_crtc *best_crtc;
1201	int my_score, best_score, score;
1202	struct drm_fb_helper_crtc **crtcs, *crtc;
1203	struct drm_fb_helper_connector *fb_helper_conn;
1204
1205	if (n == fb_helper->connector_count)
1206		return 0;
1207
1208	fb_helper_conn = fb_helper->connector_info[n];
1209	connector = fb_helper_conn->connector;
1210
1211	best_crtcs[n] = NULL;
1212	best_crtc = NULL;
1213	best_score = drm_pick_crtcs(fb_helper, best_crtcs, modes, n+1, width, height);
1214	if (modes[n] == NULL)
1215		return best_score;
1216
1217	crtcs = kzalloc(dev->mode_config.num_connector *
1218			sizeof(struct drm_fb_helper_crtc *), GFP_KERNEL);
1219	if (!crtcs)
1220		return best_score;
1221
1222	my_score = 1;
1223	if (connector->status == connector_status_connected)
1224		my_score++;
1225	if (drm_has_cmdline_mode(fb_helper_conn))
1226		my_score++;
1227	if (drm_has_preferred_mode(fb_helper_conn, width, height))
1228		my_score++;
1229
1230	connector_funcs = connector->helper_private;
1231	encoder = connector_funcs->best_encoder(connector);
 
 
 
 
 
 
 
 
 
 
 
1232	if (!encoder)
1233		goto out;
1234
1235	/* select a crtc for this connector and then attempt to configure
1236	   remaining connectors */
1237	for (c = 0; c < fb_helper->crtc_count; c++) {
1238		crtc = &fb_helper->crtc_info[c];
1239
1240		if ((encoder->possible_crtcs & (1 << c)) == 0) {
1241			continue;
1242		}
1243
1244		for (o = 0; o < n; o++)
1245			if (best_crtcs[o] == crtc)
1246				break;
1247
1248		if (o < n) {
1249			/* ignore cloning unless only a single crtc */
1250			if (fb_helper->crtc_count > 1)
1251				continue;
1252
1253			if (!drm_mode_equal(modes[o], modes[n]))
1254				continue;
1255		}
1256
1257		crtcs[n] = crtc;
1258		memcpy(crtcs, best_crtcs, n * sizeof(struct drm_fb_helper_crtc *));
1259		score = my_score + drm_pick_crtcs(fb_helper, crtcs, modes, n + 1,
1260						  width, height);
1261		if (score > best_score) {
1262			best_crtc = crtc;
1263			best_score = score;
1264			memcpy(best_crtcs, crtcs,
1265			       dev->mode_config.num_connector *
1266			       sizeof(struct drm_fb_helper_crtc *));
1267		}
1268	}
1269out:
1270	kfree(crtcs);
1271	return best_score;
1272}
1273
1274static void drm_setup_crtcs(struct drm_fb_helper *fb_helper)
 
1275{
1276	struct drm_device *dev = fb_helper->dev;
1277	struct drm_fb_helper_crtc **crtcs;
1278	struct drm_display_mode **modes;
1279	struct drm_encoder *encoder;
1280	struct drm_mode_set *modeset;
1281	bool *enabled;
1282	int width, height;
1283	int i, ret;
1284
1285	DRM_DEBUG_KMS("\n");
 
 
1286
1287	width = dev->mode_config.max_width;
1288	height = dev->mode_config.max_height;
1289
1290	/* clean out all the encoder/crtc combos */
1291	list_for_each_entry(encoder, &dev->mode_config.encoder_list, head) {
1292		encoder->crtc = NULL;
1293	}
1294
1295	crtcs = kcalloc(dev->mode_config.num_connector,
1296			sizeof(struct drm_fb_helper_crtc *), GFP_KERNEL);
1297	modes = kcalloc(dev->mode_config.num_connector,
1298			sizeof(struct drm_display_mode *), GFP_KERNEL);
1299	enabled = kcalloc(dev->mode_config.num_connector,
 
 
1300			  sizeof(bool), GFP_KERNEL);
 
 
 
 
1301
1302	drm_enable_connectors(fb_helper, enabled);
1303
1304	ret = drm_target_cloned(fb_helper, modes, enabled, width, height);
1305	if (!ret) {
1306		ret = drm_target_preferred(fb_helper, modes, enabled, width, height);
1307		if (!ret)
 
 
 
 
 
 
 
 
1308			DRM_ERROR("Unable to find initial modes\n");
1309	}
1310
1311	DRM_DEBUG_KMS("picking CRTCs for %dx%d config\n", width, height);
 
1312
1313	drm_pick_crtcs(fb_helper, crtcs, modes, 0, width, height);
 
1314
1315	/* need to set the modesets up here for use later */
1316	/* fill out the connector<->crtc mappings into the modesets */
1317	for (i = 0; i < fb_helper->crtc_count; i++) {
1318		modeset = &fb_helper->crtc_info[i].mode_set;
1319		modeset->num_connectors = 0;
1320	}
1321
1322	for (i = 0; i < fb_helper->connector_count; i++) {
1323		struct drm_display_mode *mode = modes[i];
1324		struct drm_fb_helper_crtc *fb_crtc = crtcs[i];
1325		modeset = &fb_crtc->mode_set;
 
1326
1327		if (mode && fb_crtc) {
1328			DRM_DEBUG_KMS("desired mode %s set on crtc %d\n",
1329				      mode->name, fb_crtc->mode_set.crtc->base.id);
 
 
 
 
1330			fb_crtc->desired_mode = mode;
1331			if (modeset->mode)
1332				drm_mode_destroy(dev, modeset->mode);
1333			modeset->mode = drm_mode_duplicate(dev,
1334							   fb_crtc->desired_mode);
1335			modeset->connectors[modeset->num_connectors++] = fb_helper->connector_info[i]->connector;
 
 
 
 
1336		}
1337	}
1338
1339	kfree(crtcs);
1340	kfree(modes);
 
1341	kfree(enabled);
1342}
1343
1344/**
1345 * drm_helper_initial_config - setup a sane initial connector configuration
1346 * @dev: DRM device
1347 *
1348 * LOCKING:
1349 * Called at init time, must take mode config lock.
1350 *
1351 * Scan the CRTCs and connectors and try to put together an initial setup.
1352 * At the moment, this is a cloned configuration across all heads with
1353 * a new framebuffer object as the backing store.
1354 *
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1355 * RETURNS:
1356 * Zero if everything went ok, nonzero otherwise.
1357 */
1358bool drm_fb_helper_initial_config(struct drm_fb_helper *fb_helper, int bpp_sel)
1359{
1360	struct drm_device *dev = fb_helper->dev;
1361	int count = 0;
 
1362
1363	/* disable all the possible outputs/crtcs before entering KMS mode */
1364	drm_helper_disable_unused_functions(fb_helper->dev);
1365
1366	drm_fb_helper_parse_command_line(fb_helper);
 
 
 
 
 
 
 
1367
1368	count = drm_fb_helper_probe_connector_modes(fb_helper,
1369						    dev->mode_config.max_width,
1370						    dev->mode_config.max_height);
1371	/*
1372	 * we shouldn't end up with no modes here.
1373	 */
1374	if (count == 0) {
1375		printk(KERN_INFO "No connectors reported connected with modes\n");
1376	}
1377	drm_setup_crtcs(fb_helper);
1378
1379	return drm_fb_helper_single_fb_probe(fb_helper, bpp_sel);
 
 
 
 
 
 
 
1380}
1381EXPORT_SYMBOL(drm_fb_helper_initial_config);
1382
1383/**
1384 * drm_fb_helper_hotplug_event - respond to a hotplug notification by
1385 *                               probing all the outputs attached to the fb.
1386 * @fb_helper: the drm_fb_helper
1387 *
1388 * LOCKING:
1389 * Called at runtime, must take mode config lock.
1390 *
1391 * Scan the connectors attached to the fb_helper and try to put together a
1392 * setup after *notification of a change in output configuration.
 
 
 
 
 
 
 
 
 
 
1393 *
1394 * RETURNS:
1395 * 0 on success and a non-zero error code otherwise.
1396 */
1397int drm_fb_helper_hotplug_event(struct drm_fb_helper *fb_helper)
1398{
1399	struct drm_device *dev = fb_helper->dev;
1400	int count = 0;
1401	u32 max_width, max_height, bpp_sel;
1402	bool bound = false, crtcs_bound = false;
1403	struct drm_crtc *crtc;
1404
1405	if (!fb_helper->fb)
1406		return 0;
1407
1408	mutex_lock(&dev->mode_config.mutex);
1409	list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
1410		if (crtc->fb)
1411			crtcs_bound = true;
1412		if (crtc->fb == fb_helper->fb)
1413			bound = true;
1414	}
1415
1416	if (!bound && crtcs_bound) {
1417		fb_helper->delayed_hotplug = true;
1418		mutex_unlock(&dev->mode_config.mutex);
1419		return 0;
1420	}
1421	DRM_DEBUG_KMS("\n");
1422
1423	max_width = fb_helper->fb->width;
1424	max_height = fb_helper->fb->height;
1425	bpp_sel = fb_helper->fb->bits_per_pixel;
1426
1427	count = drm_fb_helper_probe_connector_modes(fb_helper, max_width,
1428						    max_height);
1429	drm_setup_crtcs(fb_helper);
1430	mutex_unlock(&dev->mode_config.mutex);
1431
1432	return drm_fb_helper_single_fb_probe(fb_helper, bpp_sel);
 
 
1433}
1434EXPORT_SYMBOL(drm_fb_helper_hotplug_event);
1435
1436/* The Kconfig DRM_KMS_HELPER selects FRAMEBUFFER_CONSOLE (if !EXPERT)
1437 * but the module doesn't depend on any fb console symbols.  At least
1438 * attempt to load fbcon to avoid leaving the system without a usable console.
1439 */
1440#if defined(CONFIG_FRAMEBUFFER_CONSOLE_MODULE) && !defined(CONFIG_EXPERT)
1441static int __init drm_fb_helper_modinit(void)
1442{
 
1443	const char *name = "fbcon";
1444	struct module *fbcon;
1445
1446	mutex_lock(&module_mutex);
1447	fbcon = find_module(name);
1448	mutex_unlock(&module_mutex);
1449
1450	if (!fbcon)
1451		request_module_nowait(name);
 
1452	return 0;
1453}
1454
1455module_init(drm_fb_helper_modinit);
1456#endif
v4.10.11
   1/*
   2 * Copyright (c) 2006-2009 Red Hat Inc.
   3 * Copyright (c) 2006-2008 Intel Corporation
   4 * Copyright (c) 2007 Dave Airlie <airlied@linux.ie>
   5 *
   6 * DRM framebuffer helper functions
   7 *
   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.
  17 *
  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
  24 * OF THIS SOFTWARE.
  25 *
  26 * Authors:
  27 *      Dave Airlie <airlied@linux.ie>
  28 *      Jesse Barnes <jesse.barnes@intel.com>
  29 */
  30#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  31
  32#include <linux/console.h>
  33#include <linux/kernel.h>
  34#include <linux/sysrq.h>
  35#include <linux/slab.h>
  36#include <linux/module.h>
  37#include <drm/drmP.h>
  38#include <drm/drm_crtc.h>
  39#include <drm/drm_fb_helper.h>
  40#include <drm/drm_crtc_helper.h>
  41#include <drm/drm_atomic.h>
  42#include <drm/drm_atomic_helper.h>
  43
  44#include "drm_crtc_helper_internal.h"
  45
  46static bool drm_fbdev_emulation = true;
  47module_param_named(fbdev_emulation, drm_fbdev_emulation, bool, 0600);
  48MODULE_PARM_DESC(fbdev_emulation,
  49		 "Enable legacy fbdev emulation [default=true]");
  50
  51static LIST_HEAD(kernel_fb_helper_list);
  52static DEFINE_MUTEX(kernel_fb_helper_lock);
  53
  54/**
  55 * DOC: fbdev helpers
  56 *
  57 * The fb helper functions are useful to provide an fbdev on top of a drm kernel
  58 * mode setting driver. They can be used mostly independently from the crtc
  59 * helper functions used by many drivers to implement the kernel mode setting
  60 * interfaces.
  61 *
  62 * Initialization is done as a four-step process with drm_fb_helper_prepare(),
  63 * drm_fb_helper_init(), drm_fb_helper_single_add_all_connectors() and
  64 * drm_fb_helper_initial_config(). Drivers with fancier requirements than the
  65 * default behaviour can override the third step with their own code.
  66 * Teardown is done with drm_fb_helper_fini().
  67 *
  68 * At runtime drivers should restore the fbdev console by calling
  69 * drm_fb_helper_restore_fbdev_mode_unlocked() from their ->lastclose callback.
  70 * They should also notify the fb helper code from updates to the output
  71 * configuration by calling drm_fb_helper_hotplug_event(). For easier
  72 * integration with the output polling code in drm_crtc_helper.c the modeset
  73 * code provides a ->output_poll_changed callback.
  74 *
  75 * All other functions exported by the fb helper library can be used to
  76 * implement the fbdev driver interface by the driver.
  77 *
  78 * It is possible, though perhaps somewhat tricky, to implement race-free
  79 * hotplug detection using the fbdev helpers. The drm_fb_helper_prepare()
  80 * helper must be called first to initialize the minimum required to make
  81 * hotplug detection work. Drivers also need to make sure to properly set up
  82 * the dev->mode_config.funcs member. After calling drm_kms_helper_poll_init()
  83 * it is safe to enable interrupts and start processing hotplug events. At the
  84 * same time, drivers should initialize all modeset objects such as CRTCs,
  85 * encoders and connectors. To finish up the fbdev helper initialization, the
  86 * drm_fb_helper_init() function is called. To probe for all attached displays
  87 * and set up an initial configuration using the detected hardware, drivers
  88 * should call drm_fb_helper_single_add_all_connectors() followed by
  89 * drm_fb_helper_initial_config().
  90 *
  91 * If &drm_framebuffer_funcs ->dirty is set, the
  92 * drm_fb_helper_{cfb,sys}_{write,fillrect,copyarea,imageblit} functions will
  93 * accumulate changes and schedule &drm_fb_helper ->dirty_work to run right
  94 * away. This worker then calls the dirty() function ensuring that it will
  95 * always run in process context since the fb_*() function could be running in
  96 * atomic context. If drm_fb_helper_deferred_io() is used as the deferred_io
  97 * callback it will also schedule dirty_work with the damage collected from the
  98 * mmap page writes.
  99 */
 100
 101#define drm_fb_helper_for_each_connector(fbh, i__) \
 102	for (({ lockdep_assert_held(&(fbh)->dev->mode_config.mutex); }), \
 103	     i__ = 0; i__ < (fbh)->connector_count; i__++)
 104
 105/**
 106 * drm_fb_helper_single_add_all_connectors() - add all connectors to fbdev
 107 * 					       emulation helper
 108 * @fb_helper: fbdev initialized with drm_fb_helper_init
 109 *
 110 * This functions adds all the available connectors for use with the given
 111 * fb_helper. This is a separate step to allow drivers to freely assign
 112 * connectors to the fbdev, e.g. if some are reserved for special purposes or
 113 * not adequate to be used for the fbcon.
 114 *
 115 * This function is protected against concurrent connector hotadds/removals
 116 * using drm_fb_helper_add_one_connector() and
 117 * drm_fb_helper_remove_one_connector().
 118 */
 119int drm_fb_helper_single_add_all_connectors(struct drm_fb_helper *fb_helper)
 120{
 121	struct drm_device *dev = fb_helper->dev;
 122	struct drm_connector *connector;
 123	int i, ret;
 124
 125	if (!drm_fbdev_emulation)
 126		return 0;
 127
 128	mutex_lock(&dev->mode_config.mutex);
 129	drm_for_each_connector(connector, dev) {
 130		ret = drm_fb_helper_add_one_connector(fb_helper, connector);
 131
 132		if (ret)
 133			goto fail;
 134	}
 135	mutex_unlock(&dev->mode_config.mutex);
 136	return 0;
 137fail:
 138	drm_fb_helper_for_each_connector(fb_helper, i) {
 139		struct drm_fb_helper_connector *fb_helper_connector =
 140			fb_helper->connector_info[i];
 141
 142		drm_connector_unreference(fb_helper_connector->connector);
 143
 144		kfree(fb_helper_connector);
 145		fb_helper->connector_info[i] = NULL;
 146	}
 147	fb_helper->connector_count = 0;
 148	mutex_unlock(&dev->mode_config.mutex);
 149
 150	return ret;
 151}
 152EXPORT_SYMBOL(drm_fb_helper_single_add_all_connectors);
 153
 154int drm_fb_helper_add_one_connector(struct drm_fb_helper *fb_helper, struct drm_connector *connector)
 155{
 156	struct drm_fb_helper_connector **temp;
 157	struct drm_fb_helper_connector *fb_helper_connector;
 158
 159	if (!drm_fbdev_emulation)
 160		return 0;
 
 
 161
 162	WARN_ON(!mutex_is_locked(&fb_helper->dev->mode_config.mutex));
 163	if (fb_helper->connector_count + 1 > fb_helper->connector_info_alloc_count) {
 164		temp = krealloc(fb_helper->connector_info, sizeof(struct drm_fb_helper_connector *) * (fb_helper->connector_count + 1), GFP_KERNEL);
 165		if (!temp)
 166			return -ENOMEM;
 167
 168		fb_helper->connector_info_alloc_count = fb_helper->connector_count + 1;
 169		fb_helper->connector_info = temp;
 170	}
 171
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 172
 173	fb_helper_connector = kzalloc(sizeof(struct drm_fb_helper_connector), GFP_KERNEL);
 174	if (!fb_helper_connector)
 175		return -ENOMEM;
 176
 177	drm_connector_reference(connector);
 178	fb_helper_connector->connector = connector;
 179	fb_helper->connector_info[fb_helper->connector_count++] = fb_helper_connector;
 180	return 0;
 181}
 182EXPORT_SYMBOL(drm_fb_helper_add_one_connector);
 183
 184int drm_fb_helper_remove_one_connector(struct drm_fb_helper *fb_helper,
 185				       struct drm_connector *connector)
 186{
 187	struct drm_fb_helper_connector *fb_helper_connector;
 188	int i, j;
 189
 190	if (!drm_fbdev_emulation)
 191		return 0;
 192
 193	WARN_ON(!mutex_is_locked(&fb_helper->dev->mode_config.mutex));
 194
 195	for (i = 0; i < fb_helper->connector_count; i++) {
 196		if (fb_helper->connector_info[i]->connector == connector)
 197			break;
 198	}
 199
 200	if (i == fb_helper->connector_count)
 201		return -EINVAL;
 202	fb_helper_connector = fb_helper->connector_info[i];
 203	drm_connector_unreference(fb_helper_connector->connector);
 204
 205	for (j = i + 1; j < fb_helper->connector_count; j++) {
 206		fb_helper->connector_info[j - 1] = fb_helper->connector_info[j];
 207	}
 208	fb_helper->connector_count--;
 209	kfree(fb_helper_connector);
 210
 211	return 0;
 212}
 213EXPORT_SYMBOL(drm_fb_helper_remove_one_connector);
 214
 215static void drm_fb_helper_save_lut_atomic(struct drm_crtc *crtc, struct drm_fb_helper *helper)
 216{
 217	uint16_t *r_base, *g_base, *b_base;
 218	int i;
 219
 220	if (helper->funcs->gamma_get == NULL)
 221		return;
 222
 223	r_base = crtc->gamma_store;
 224	g_base = r_base + crtc->gamma_size;
 225	b_base = g_base + crtc->gamma_size;
 226
 227	for (i = 0; i < crtc->gamma_size; i++)
 228		helper->funcs->gamma_get(crtc, &r_base[i], &g_base[i], &b_base[i], i);
 229}
 230
 231static void drm_fb_helper_restore_lut_atomic(struct drm_crtc *crtc)
 232{
 233	uint16_t *r_base, *g_base, *b_base;
 234
 235	if (crtc->funcs->gamma_set == NULL)
 236		return;
 237
 238	r_base = crtc->gamma_store;
 239	g_base = r_base + crtc->gamma_size;
 240	b_base = g_base + crtc->gamma_size;
 241
 242	crtc->funcs->gamma_set(crtc, r_base, g_base, b_base, crtc->gamma_size);
 243}
 244
 245/**
 246 * drm_fb_helper_debug_enter - implementation for ->fb_debug_enter
 247 * @info: fbdev registered by the helper
 248 */
 249int drm_fb_helper_debug_enter(struct fb_info *info)
 250{
 251	struct drm_fb_helper *helper = info->par;
 252	const struct drm_crtc_helper_funcs *funcs;
 253	int i;
 254
 
 
 
 255	list_for_each_entry(helper, &kernel_fb_helper_list, kernel_fb_list) {
 256		for (i = 0; i < helper->crtc_count; i++) {
 257			struct drm_mode_set *mode_set =
 258				&helper->crtc_info[i].mode_set;
 259
 260			if (!mode_set->crtc->enabled)
 261				continue;
 262
 263			funcs =	mode_set->crtc->helper_private;
 264			if (funcs->mode_set_base_atomic == NULL)
 265				continue;
 266
 267			drm_fb_helper_save_lut_atomic(mode_set->crtc, helper);
 268			funcs->mode_set_base_atomic(mode_set->crtc,
 269						    mode_set->fb,
 270						    mode_set->x,
 271						    mode_set->y,
 272						    ENTER_ATOMIC_MODE_SET);
 273		}
 274	}
 275
 276	return 0;
 277}
 278EXPORT_SYMBOL(drm_fb_helper_debug_enter);
 279
 280/* Find the real fb for a given fb helper CRTC */
 281static struct drm_framebuffer *drm_mode_config_fb(struct drm_crtc *crtc)
 282{
 283	struct drm_device *dev = crtc->dev;
 284	struct drm_crtc *c;
 285
 286	drm_for_each_crtc(c, dev) {
 287		if (crtc->base.id == c->base.id)
 288			return c->primary->fb;
 289	}
 290
 291	return NULL;
 292}
 293
 294/**
 295 * drm_fb_helper_debug_leave - implementation for ->fb_debug_leave
 296 * @info: fbdev registered by the helper
 297 */
 298int drm_fb_helper_debug_leave(struct fb_info *info)
 299{
 300	struct drm_fb_helper *helper = info->par;
 301	struct drm_crtc *crtc;
 302	const struct drm_crtc_helper_funcs *funcs;
 303	struct drm_framebuffer *fb;
 304	int i;
 305
 306	for (i = 0; i < helper->crtc_count; i++) {
 307		struct drm_mode_set *mode_set = &helper->crtc_info[i].mode_set;
 308		crtc = mode_set->crtc;
 309		funcs = crtc->helper_private;
 310		fb = drm_mode_config_fb(crtc);
 311
 312		if (!crtc->enabled)
 313			continue;
 314
 315		if (!fb) {
 316			DRM_ERROR("no fb to restore??\n");
 317			continue;
 318		}
 319
 320		if (funcs->mode_set_base_atomic == NULL)
 321			continue;
 322
 323		drm_fb_helper_restore_lut_atomic(mode_set->crtc);
 324		funcs->mode_set_base_atomic(mode_set->crtc, fb, crtc->x,
 325					    crtc->y, LEAVE_ATOMIC_MODE_SET);
 326	}
 327
 328	return 0;
 329}
 330EXPORT_SYMBOL(drm_fb_helper_debug_leave);
 331
 332static int restore_fbdev_mode_atomic(struct drm_fb_helper *fb_helper)
 333{
 334	struct drm_device *dev = fb_helper->dev;
 335	struct drm_plane *plane;
 336	struct drm_atomic_state *state;
 337	int i, ret;
 338	unsigned plane_mask;
 339
 340	state = drm_atomic_state_alloc(dev);
 341	if (!state)
 342		return -ENOMEM;
 343
 344	state->acquire_ctx = dev->mode_config.acquire_ctx;
 345retry:
 346	plane_mask = 0;
 347	drm_for_each_plane(plane, dev) {
 348		struct drm_plane_state *plane_state;
 349
 350		plane_state = drm_atomic_get_plane_state(state, plane);
 351		if (IS_ERR(plane_state)) {
 352			ret = PTR_ERR(plane_state);
 353			goto fail;
 354		}
 355
 356		plane_state->rotation = DRM_ROTATE_0;
 357
 358		plane->old_fb = plane->fb;
 359		plane_mask |= 1 << drm_plane_index(plane);
 360
 361		/* disable non-primary: */
 362		if (plane->type == DRM_PLANE_TYPE_PRIMARY)
 363			continue;
 364
 365		ret = __drm_atomic_helper_disable_plane(plane, plane_state);
 366		if (ret != 0)
 367			goto fail;
 368	}
 369
 370	for(i = 0; i < fb_helper->crtc_count; i++) {
 371		struct drm_mode_set *mode_set = &fb_helper->crtc_info[i].mode_set;
 372
 373		ret = __drm_atomic_helper_set_config(mode_set, state);
 374		if (ret != 0)
 375			goto fail;
 376	}
 377
 378	ret = drm_atomic_commit(state);
 379
 380fail:
 381	drm_atomic_clean_old_fb(dev, plane_mask, ret);
 382
 383	if (ret == -EDEADLK)
 384		goto backoff;
 385
 386	drm_atomic_state_put(state);
 387	return ret;
 388
 389backoff:
 390	drm_atomic_state_clear(state);
 391	drm_atomic_legacy_backoff(state);
 392
 393	goto retry;
 394}
 395
 396static int restore_fbdev_mode(struct drm_fb_helper *fb_helper)
 397{
 398	struct drm_device *dev = fb_helper->dev;
 399	struct drm_plane *plane;
 400	int i;
 401
 402	drm_warn_on_modeset_not_all_locked(dev);
 403
 404	if (dev->mode_config.funcs->atomic_commit)
 405		return restore_fbdev_mode_atomic(fb_helper);
 406
 407	drm_for_each_plane(plane, dev) {
 408		if (plane->type != DRM_PLANE_TYPE_PRIMARY)
 409			drm_plane_force_disable(plane);
 410
 411		if (plane->rotation_property)
 412			drm_mode_plane_set_obj_prop(plane,
 413						    plane->rotation_property,
 414						    DRM_ROTATE_0);
 415	}
 416
 417	for (i = 0; i < fb_helper->crtc_count; i++) {
 418		struct drm_mode_set *mode_set = &fb_helper->crtc_info[i].mode_set;
 419		struct drm_crtc *crtc = mode_set->crtc;
 420		int ret;
 421
 422		if (crtc->funcs->cursor_set2) {
 423			ret = crtc->funcs->cursor_set2(crtc, NULL, 0, 0, 0, 0, 0);
 424			if (ret)
 425				return ret;
 426		} else if (crtc->funcs->cursor_set) {
 427			ret = crtc->funcs->cursor_set(crtc, NULL, 0, 0, 0);
 428			if (ret)
 429				return ret;
 430		}
 431
 432		ret = drm_mode_set_config_internal(mode_set);
 433		if (ret)
 434			return ret;
 435	}
 436
 437	return 0;
 438}
 
 439
 440/**
 441 * drm_fb_helper_restore_fbdev_mode_unlocked - restore fbdev configuration
 442 * @fb_helper: fbcon to restore
 443 *
 444 * This should be called from driver's drm ->lastclose callback
 445 * when implementing an fbcon on top of kms using this helper. This ensures that
 446 * the user isn't greeted with a black screen when e.g. X dies.
 447 *
 448 * RETURNS:
 449 * Zero if everything went ok, negative error code otherwise.
 450 */
 451int drm_fb_helper_restore_fbdev_mode_unlocked(struct drm_fb_helper *fb_helper)
 452{
 453	struct drm_device *dev = fb_helper->dev;
 454	bool do_delayed;
 455	int ret;
 456
 457	if (!drm_fbdev_emulation)
 458		return -ENODEV;
 459
 460	drm_modeset_lock_all(dev);
 461	ret = restore_fbdev_mode(fb_helper);
 462
 463	do_delayed = fb_helper->delayed_hotplug;
 464	if (do_delayed)
 465		fb_helper->delayed_hotplug = false;
 466	drm_modeset_unlock_all(dev);
 467
 468	if (do_delayed)
 469		drm_fb_helper_hotplug_event(fb_helper);
 470	return ret;
 471}
 472EXPORT_SYMBOL(drm_fb_helper_restore_fbdev_mode_unlocked);
 473
 474static bool drm_fb_helper_is_bound(struct drm_fb_helper *fb_helper)
 475{
 476	struct drm_device *dev = fb_helper->dev;
 477	struct drm_crtc *crtc;
 478	int bound = 0, crtcs_bound = 0;
 479
 480	/* Sometimes user space wants everything disabled, so don't steal the
 481	 * display if there's a master. */
 482	if (READ_ONCE(dev->master))
 483		return false;
 484
 485	drm_for_each_crtc(crtc, dev) {
 486		if (crtc->primary->fb)
 487			crtcs_bound++;
 488		if (crtc->primary->fb == fb_helper->fb)
 489			bound++;
 490	}
 491
 492	if (bound < crtcs_bound)
 493		return false;
 494
 495	return true;
 496}
 497
 498#ifdef CONFIG_MAGIC_SYSRQ
 499/*
 500 * restore fbcon display for all kms driver's using this helper, used for sysrq
 501 * and panic handling.
 502 */
 503static bool drm_fb_helper_force_kernel_mode(void)
 504{
 505	bool ret, error = false;
 506	struct drm_fb_helper *helper;
 507
 508	if (list_empty(&kernel_fb_helper_list))
 509		return false;
 510
 511	list_for_each_entry(helper, &kernel_fb_helper_list, kernel_fb_list) {
 512		struct drm_device *dev = helper->dev;
 513
 514		if (dev->switch_power_state == DRM_SWITCH_POWER_OFF)
 515			continue;
 516
 517		drm_modeset_lock_all(dev);
 518		ret = restore_fbdev_mode(helper);
 519		if (ret)
 520			error = true;
 521		drm_modeset_unlock_all(dev);
 522	}
 523	return error;
 524}
 525
 526static void drm_fb_helper_restore_work_fn(struct work_struct *ignored)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 527{
 528	bool ret;
 529	ret = drm_fb_helper_force_kernel_mode();
 530	if (ret == true)
 531		DRM_ERROR("Failed to restore crtc configuration\n");
 532}
 
 
 
 
 
 
 
 533static DECLARE_WORK(drm_fb_helper_restore_work, drm_fb_helper_restore_work_fn);
 534
 535static void drm_fb_helper_sysrq(int dummy1)
 536{
 537	schedule_work(&drm_fb_helper_restore_work);
 538}
 539
 540static struct sysrq_key_op sysrq_drm_fb_helper_restore_op = {
 541	.handler = drm_fb_helper_sysrq,
 542	.help_msg = "force-fb(V)",
 543	.action_msg = "Restore framebuffer console",
 544};
 545#else
 546static struct sysrq_key_op sysrq_drm_fb_helper_restore_op = { };
 547#endif
 548
 549static void drm_fb_helper_dpms(struct fb_info *info, int dpms_mode)
 550{
 551	struct drm_fb_helper *fb_helper = info->par;
 552	struct drm_device *dev = fb_helper->dev;
 553	struct drm_crtc *crtc;
 
 554	struct drm_connector *connector;
 
 555	int i, j;
 556
 557	/*
 558	 * For each CRTC in this fb, turn the connectors on/off.
 
 559	 */
 560	drm_modeset_lock_all(dev);
 561	if (!drm_fb_helper_is_bound(fb_helper)) {
 562		drm_modeset_unlock_all(dev);
 563		return;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 564	}
 
 
 
 
 
 
 
 
 
 
 
 
 565
 
 
 
 
 
 566	for (i = 0; i < fb_helper->crtc_count; i++) {
 567		crtc = fb_helper->crtc_info[i].mode_set.crtc;
 
 568
 569		if (!crtc->enabled)
 570			continue;
 571
 572		/* Walk the connectors & encoders on this fb turning them on/off */
 573		drm_fb_helper_for_each_connector(fb_helper, j) {
 574			connector = fb_helper->connector_info[j]->connector;
 575			connector->funcs->dpms(connector, dpms_mode);
 576			drm_object_property_set_value(&connector->base,
 577				dev->mode_config.dpms_property, dpms_mode);
 
 
 
 
 
 
 
 
 
 
 578		}
 
 579	}
 580	drm_modeset_unlock_all(dev);
 581}
 582
 583/**
 584 * drm_fb_helper_blank - implementation for ->fb_blank
 585 * @blank: desired blanking state
 586 * @info: fbdev registered by the helper
 587 */
 588int drm_fb_helper_blank(int blank, struct fb_info *info)
 589{
 590	if (oops_in_progress)
 591		return -EBUSY;
 592
 593	switch (blank) {
 594	/* Display: On; HSync: On, VSync: On */
 595	case FB_BLANK_UNBLANK:
 596		drm_fb_helper_dpms(info, DRM_MODE_DPMS_ON);
 597		break;
 598	/* Display: Off; HSync: On, VSync: On */
 599	case FB_BLANK_NORMAL:
 600		drm_fb_helper_dpms(info, DRM_MODE_DPMS_STANDBY);
 601		break;
 602	/* Display: Off; HSync: Off, VSync: On */
 603	case FB_BLANK_HSYNC_SUSPEND:
 604		drm_fb_helper_dpms(info, DRM_MODE_DPMS_STANDBY);
 605		break;
 606	/* Display: Off; HSync: On, VSync: Off */
 607	case FB_BLANK_VSYNC_SUSPEND:
 608		drm_fb_helper_dpms(info, DRM_MODE_DPMS_SUSPEND);
 609		break;
 610	/* Display: Off; HSync: Off, VSync: Off */
 611	case FB_BLANK_POWERDOWN:
 612		drm_fb_helper_dpms(info, DRM_MODE_DPMS_OFF);
 613		break;
 614	}
 615	return 0;
 616}
 617EXPORT_SYMBOL(drm_fb_helper_blank);
 618
 619static void drm_fb_helper_modeset_release(struct drm_fb_helper *helper,
 620					  struct drm_mode_set *modeset)
 621{
 622	int i;
 623
 624	for (i = 0; i < modeset->num_connectors; i++) {
 625		drm_connector_unreference(modeset->connectors[i]);
 626		modeset->connectors[i] = NULL;
 627	}
 628	modeset->num_connectors = 0;
 629
 630	drm_mode_destroy(helper->dev, modeset->mode);
 631	modeset->mode = NULL;
 632
 633	/* FIXME should hold a ref? */
 634	modeset->fb = NULL;
 635}
 636
 637static void drm_fb_helper_crtc_free(struct drm_fb_helper *helper)
 638{
 639	int i;
 640
 641	for (i = 0; i < helper->connector_count; i++) {
 642		drm_connector_unreference(helper->connector_info[i]->connector);
 643		kfree(helper->connector_info[i]);
 644	}
 645	kfree(helper->connector_info);
 646
 647	for (i = 0; i < helper->crtc_count; i++) {
 648		struct drm_mode_set *modeset = &helper->crtc_info[i].mode_set;
 649
 650		drm_fb_helper_modeset_release(helper, modeset);
 651		kfree(modeset->connectors);
 652	}
 653	kfree(helper->crtc_info);
 654}
 655
 656static void drm_fb_helper_resume_worker(struct work_struct *work)
 657{
 658	struct drm_fb_helper *helper = container_of(work, struct drm_fb_helper,
 659						    resume_work);
 660
 661	console_lock();
 662	fb_set_suspend(helper->fbdev, 0);
 663	console_unlock();
 664}
 665
 666static void drm_fb_helper_dirty_work(struct work_struct *work)
 667{
 668	struct drm_fb_helper *helper = container_of(work, struct drm_fb_helper,
 669						    dirty_work);
 670	struct drm_clip_rect *clip = &helper->dirty_clip;
 671	struct drm_clip_rect clip_copy;
 672	unsigned long flags;
 673
 674	spin_lock_irqsave(&helper->dirty_lock, flags);
 675	clip_copy = *clip;
 676	clip->x1 = clip->y1 = ~0;
 677	clip->x2 = clip->y2 = 0;
 678	spin_unlock_irqrestore(&helper->dirty_lock, flags);
 679
 680	/* call dirty callback only when it has been really touched */
 681	if (clip_copy.x1 < clip_copy.x2 && clip_copy.y1 < clip_copy.y2)
 682		helper->fb->funcs->dirty(helper->fb, NULL, 0, 0, &clip_copy, 1);
 683}
 684
 685/**
 686 * drm_fb_helper_prepare - setup a drm_fb_helper structure
 687 * @dev: DRM device
 688 * @helper: driver-allocated fbdev helper structure to set up
 689 * @funcs: pointer to structure of functions associate with this helper
 690 *
 691 * Sets up the bare minimum to make the framebuffer helper usable. This is
 692 * useful to implement race-free initialization of the polling helpers.
 693 */
 694void drm_fb_helper_prepare(struct drm_device *dev, struct drm_fb_helper *helper,
 695			   const struct drm_fb_helper_funcs *funcs)
 696{
 697	INIT_LIST_HEAD(&helper->kernel_fb_list);
 698	spin_lock_init(&helper->dirty_lock);
 699	INIT_WORK(&helper->resume_work, drm_fb_helper_resume_worker);
 700	INIT_WORK(&helper->dirty_work, drm_fb_helper_dirty_work);
 701	helper->dirty_clip.x1 = helper->dirty_clip.y1 = ~0;
 702	helper->funcs = funcs;
 703	helper->dev = dev;
 704}
 705EXPORT_SYMBOL(drm_fb_helper_prepare);
 706
 707/**
 708 * drm_fb_helper_init - initialize a drm_fb_helper structure
 709 * @dev: drm device
 710 * @fb_helper: driver-allocated fbdev helper structure to initialize
 711 * @crtc_count: maximum number of crtcs to support in this fbdev emulation
 712 * @max_conn_count: max connector count
 713 *
 714 * This allocates the structures for the fbdev helper with the given limits.
 715 * Note that this won't yet touch the hardware (through the driver interfaces)
 716 * nor register the fbdev. This is only done in drm_fb_helper_initial_config()
 717 * to allow driver writes more control over the exact init sequence.
 718 *
 719 * Drivers must call drm_fb_helper_prepare() before calling this function.
 720 *
 721 * RETURNS:
 722 * Zero if everything went ok, nonzero otherwise.
 723 */
 724int drm_fb_helper_init(struct drm_device *dev,
 725		       struct drm_fb_helper *fb_helper,
 726		       int crtc_count, int max_conn_count)
 727{
 728	struct drm_crtc *crtc;
 
 729	int i;
 730
 731	if (!drm_fbdev_emulation)
 732		return 0;
 733
 734	if (!max_conn_count)
 735		return -EINVAL;
 736
 737	fb_helper->crtc_info = kcalloc(crtc_count, sizeof(struct drm_fb_helper_crtc), GFP_KERNEL);
 738	if (!fb_helper->crtc_info)
 739		return -ENOMEM;
 740
 741	fb_helper->crtc_count = crtc_count;
 742	fb_helper->connector_info = kcalloc(dev->mode_config.num_connector, sizeof(struct drm_fb_helper_connector *), GFP_KERNEL);
 743	if (!fb_helper->connector_info) {
 744		kfree(fb_helper->crtc_info);
 745		return -ENOMEM;
 746	}
 747	fb_helper->connector_info_alloc_count = dev->mode_config.num_connector;
 748	fb_helper->connector_count = 0;
 749
 750	for (i = 0; i < crtc_count; i++) {
 751		fb_helper->crtc_info[i].mode_set.connectors =
 752			kcalloc(max_conn_count,
 753				sizeof(struct drm_connector *),
 754				GFP_KERNEL);
 755
 756		if (!fb_helper->crtc_info[i].mode_set.connectors)
 
 757			goto out_free;
 
 758		fb_helper->crtc_info[i].mode_set.num_connectors = 0;
 759	}
 760
 761	i = 0;
 762	drm_for_each_crtc(crtc, dev) {
 
 763		fb_helper->crtc_info[i].mode_set.crtc = crtc;
 764		i++;
 765	}
 766
 767	return 0;
 768out_free:
 769	drm_fb_helper_crtc_free(fb_helper);
 770	return -ENOMEM;
 771}
 772EXPORT_SYMBOL(drm_fb_helper_init);
 773
 774/**
 775 * drm_fb_helper_alloc_fbi - allocate fb_info and some of its members
 776 * @fb_helper: driver-allocated fbdev helper
 777 *
 778 * A helper to alloc fb_info and the members cmap and apertures. Called
 779 * by the driver within the fb_probe fb_helper callback function.
 780 *
 781 * RETURNS:
 782 * fb_info pointer if things went okay, pointer containing error code
 783 * otherwise
 784 */
 785struct fb_info *drm_fb_helper_alloc_fbi(struct drm_fb_helper *fb_helper)
 786{
 787	struct device *dev = fb_helper->dev->dev;
 788	struct fb_info *info;
 789	int ret;
 790
 791	info = framebuffer_alloc(0, dev);
 792	if (!info)
 793		return ERR_PTR(-ENOMEM);
 794
 795	ret = fb_alloc_cmap(&info->cmap, 256, 0);
 796	if (ret)
 797		goto err_release;
 798
 799	info->apertures = alloc_apertures(1);
 800	if (!info->apertures) {
 801		ret = -ENOMEM;
 802		goto err_free_cmap;
 803	}
 804
 805	fb_helper->fbdev = info;
 806
 807	return info;
 808
 809err_free_cmap:
 810	fb_dealloc_cmap(&info->cmap);
 811err_release:
 812	framebuffer_release(info);
 813	return ERR_PTR(ret);
 814}
 815EXPORT_SYMBOL(drm_fb_helper_alloc_fbi);
 816
 817/**
 818 * drm_fb_helper_unregister_fbi - unregister fb_info framebuffer device
 819 * @fb_helper: driver-allocated fbdev helper
 820 *
 821 * A wrapper around unregister_framebuffer, to release the fb_info
 822 * framebuffer device
 823 */
 824void drm_fb_helper_unregister_fbi(struct drm_fb_helper *fb_helper)
 825{
 826	if (fb_helper && fb_helper->fbdev)
 827		unregister_framebuffer(fb_helper->fbdev);
 828}
 829EXPORT_SYMBOL(drm_fb_helper_unregister_fbi);
 830
 831/**
 832 * drm_fb_helper_release_fbi - dealloc fb_info and its members
 833 * @fb_helper: driver-allocated fbdev helper
 834 *
 835 * A helper to free memory taken by fb_info and the members cmap and
 836 * apertures
 837 */
 838void drm_fb_helper_release_fbi(struct drm_fb_helper *fb_helper)
 839{
 840	if (fb_helper) {
 841		struct fb_info *info = fb_helper->fbdev;
 842
 843		if (info) {
 844			if (info->cmap.len)
 845				fb_dealloc_cmap(&info->cmap);
 846			framebuffer_release(info);
 847		}
 848
 849		fb_helper->fbdev = NULL;
 850	}
 851}
 852EXPORT_SYMBOL(drm_fb_helper_release_fbi);
 853
 854void drm_fb_helper_fini(struct drm_fb_helper *fb_helper)
 855{
 856	if (!drm_fbdev_emulation)
 857		return;
 858
 859	cancel_work_sync(&fb_helper->resume_work);
 860	cancel_work_sync(&fb_helper->dirty_work);
 861
 862	mutex_lock(&kernel_fb_helper_lock);
 863	if (!list_empty(&fb_helper->kernel_fb_list)) {
 864		list_del(&fb_helper->kernel_fb_list);
 865		if (list_empty(&kernel_fb_helper_list)) {
 
 
 
 866			unregister_sysrq_key('v', &sysrq_drm_fb_helper_restore_op);
 867		}
 868	}
 869	mutex_unlock(&kernel_fb_helper_lock);
 870
 871	drm_fb_helper_crtc_free(fb_helper);
 872
 873}
 874EXPORT_SYMBOL(drm_fb_helper_fini);
 875
 876/**
 877 * drm_fb_helper_unlink_fbi - wrapper around unlink_framebuffer
 878 * @fb_helper: driver-allocated fbdev helper
 879 *
 880 * A wrapper around unlink_framebuffer implemented by fbdev core
 881 */
 882void drm_fb_helper_unlink_fbi(struct drm_fb_helper *fb_helper)
 883{
 884	if (fb_helper && fb_helper->fbdev)
 885		unlink_framebuffer(fb_helper->fbdev);
 886}
 887EXPORT_SYMBOL(drm_fb_helper_unlink_fbi);
 888
 889static void drm_fb_helper_dirty(struct fb_info *info, u32 x, u32 y,
 890				u32 width, u32 height)
 891{
 892	struct drm_fb_helper *helper = info->par;
 893	struct drm_clip_rect *clip = &helper->dirty_clip;
 894	unsigned long flags;
 895
 896	if (!helper->fb->funcs->dirty)
 897		return;
 898
 899	spin_lock_irqsave(&helper->dirty_lock, flags);
 900	clip->x1 = min_t(u32, clip->x1, x);
 901	clip->y1 = min_t(u32, clip->y1, y);
 902	clip->x2 = max_t(u32, clip->x2, x + width);
 903	clip->y2 = max_t(u32, clip->y2, y + height);
 904	spin_unlock_irqrestore(&helper->dirty_lock, flags);
 905
 906	schedule_work(&helper->dirty_work);
 907}
 908
 909/**
 910 * drm_fb_helper_deferred_io() - fbdev deferred_io callback function
 911 * @info: fb_info struct pointer
 912 * @pagelist: list of dirty mmap framebuffer pages
 913 *
 914 * This function is used as the &fb_deferred_io ->deferred_io
 915 * callback function for flushing the fbdev mmap writes.
 916 */
 917void drm_fb_helper_deferred_io(struct fb_info *info,
 918			       struct list_head *pagelist)
 919{
 920	unsigned long start, end, min, max;
 921	struct page *page;
 922	u32 y1, y2;
 923
 924	min = ULONG_MAX;
 925	max = 0;
 926	list_for_each_entry(page, pagelist, lru) {
 927		start = page->index << PAGE_SHIFT;
 928		end = start + PAGE_SIZE - 1;
 929		min = min(min, start);
 930		max = max(max, end);
 931	}
 932
 933	if (min < max) {
 934		y1 = min / info->fix.line_length;
 935		y2 = min_t(u32, DIV_ROUND_UP(max, info->fix.line_length),
 936			   info->var.yres);
 937		drm_fb_helper_dirty(info, 0, y1, info->var.xres, y2 - y1);
 938	}
 939}
 940EXPORT_SYMBOL(drm_fb_helper_deferred_io);
 941
 942/**
 943 * drm_fb_helper_sys_read - wrapper around fb_sys_read
 944 * @info: fb_info struct pointer
 945 * @buf: userspace buffer to read from framebuffer memory
 946 * @count: number of bytes to read from framebuffer memory
 947 * @ppos: read offset within framebuffer memory
 948 *
 949 * A wrapper around fb_sys_read implemented by fbdev core
 950 */
 951ssize_t drm_fb_helper_sys_read(struct fb_info *info, char __user *buf,
 952			       size_t count, loff_t *ppos)
 953{
 954	return fb_sys_read(info, buf, count, ppos);
 955}
 956EXPORT_SYMBOL(drm_fb_helper_sys_read);
 957
 958/**
 959 * drm_fb_helper_sys_write - wrapper around fb_sys_write
 960 * @info: fb_info struct pointer
 961 * @buf: userspace buffer to write to framebuffer memory
 962 * @count: number of bytes to write to framebuffer memory
 963 * @ppos: write offset within framebuffer memory
 964 *
 965 * A wrapper around fb_sys_write implemented by fbdev core
 966 */
 967ssize_t drm_fb_helper_sys_write(struct fb_info *info, const char __user *buf,
 968				size_t count, loff_t *ppos)
 969{
 970	ssize_t ret;
 971
 972	ret = fb_sys_write(info, buf, count, ppos);
 973	if (ret > 0)
 974		drm_fb_helper_dirty(info, 0, 0, info->var.xres,
 975				    info->var.yres);
 976
 977	return ret;
 978}
 979EXPORT_SYMBOL(drm_fb_helper_sys_write);
 980
 981/**
 982 * drm_fb_helper_sys_fillrect - wrapper around sys_fillrect
 983 * @info: fbdev registered by the helper
 984 * @rect: info about rectangle to fill
 985 *
 986 * A wrapper around sys_fillrect implemented by fbdev core
 987 */
 988void drm_fb_helper_sys_fillrect(struct fb_info *info,
 989				const struct fb_fillrect *rect)
 990{
 991	sys_fillrect(info, rect);
 992	drm_fb_helper_dirty(info, rect->dx, rect->dy,
 993			    rect->width, rect->height);
 994}
 995EXPORT_SYMBOL(drm_fb_helper_sys_fillrect);
 996
 997/**
 998 * drm_fb_helper_sys_copyarea - wrapper around sys_copyarea
 999 * @info: fbdev registered by the helper
1000 * @area: info about area to copy
1001 *
1002 * A wrapper around sys_copyarea implemented by fbdev core
1003 */
1004void drm_fb_helper_sys_copyarea(struct fb_info *info,
1005				const struct fb_copyarea *area)
1006{
1007	sys_copyarea(info, area);
1008	drm_fb_helper_dirty(info, area->dx, area->dy,
1009			    area->width, area->height);
1010}
1011EXPORT_SYMBOL(drm_fb_helper_sys_copyarea);
1012
1013/**
1014 * drm_fb_helper_sys_imageblit - wrapper around sys_imageblit
1015 * @info: fbdev registered by the helper
1016 * @image: info about image to blit
1017 *
1018 * A wrapper around sys_imageblit implemented by fbdev core
1019 */
1020void drm_fb_helper_sys_imageblit(struct fb_info *info,
1021				 const struct fb_image *image)
1022{
1023	sys_imageblit(info, image);
1024	drm_fb_helper_dirty(info, image->dx, image->dy,
1025			    image->width, image->height);
1026}
1027EXPORT_SYMBOL(drm_fb_helper_sys_imageblit);
1028
1029/**
1030 * drm_fb_helper_cfb_fillrect - wrapper around cfb_fillrect
1031 * @info: fbdev registered by the helper
1032 * @rect: info about rectangle to fill
1033 *
1034 * A wrapper around cfb_imageblit implemented by fbdev core
1035 */
1036void drm_fb_helper_cfb_fillrect(struct fb_info *info,
1037				const struct fb_fillrect *rect)
1038{
1039	cfb_fillrect(info, rect);
1040	drm_fb_helper_dirty(info, rect->dx, rect->dy,
1041			    rect->width, rect->height);
1042}
1043EXPORT_SYMBOL(drm_fb_helper_cfb_fillrect);
1044
1045/**
1046 * drm_fb_helper_cfb_copyarea - wrapper around cfb_copyarea
1047 * @info: fbdev registered by the helper
1048 * @area: info about area to copy
1049 *
1050 * A wrapper around cfb_copyarea implemented by fbdev core
1051 */
1052void drm_fb_helper_cfb_copyarea(struct fb_info *info,
1053				const struct fb_copyarea *area)
1054{
1055	cfb_copyarea(info, area);
1056	drm_fb_helper_dirty(info, area->dx, area->dy,
1057			    area->width, area->height);
1058}
1059EXPORT_SYMBOL(drm_fb_helper_cfb_copyarea);
1060
1061/**
1062 * drm_fb_helper_cfb_imageblit - wrapper around cfb_imageblit
1063 * @info: fbdev registered by the helper
1064 * @image: info about image to blit
1065 *
1066 * A wrapper around cfb_imageblit implemented by fbdev core
1067 */
1068void drm_fb_helper_cfb_imageblit(struct fb_info *info,
1069				 const struct fb_image *image)
1070{
1071	cfb_imageblit(info, image);
1072	drm_fb_helper_dirty(info, image->dx, image->dy,
1073			    image->width, image->height);
1074}
1075EXPORT_SYMBOL(drm_fb_helper_cfb_imageblit);
1076
1077/**
1078 * drm_fb_helper_set_suspend - wrapper around fb_set_suspend
1079 * @fb_helper: driver-allocated fbdev helper
1080 * @suspend: whether to suspend or resume
1081 *
1082 * A wrapper around fb_set_suspend implemented by fbdev core.
1083 * Use drm_fb_helper_set_suspend_unlocked() if you don't need to take
1084 * the lock yourself
1085 */
1086void drm_fb_helper_set_suspend(struct drm_fb_helper *fb_helper, bool suspend)
1087{
1088	if (fb_helper && fb_helper->fbdev)
1089		fb_set_suspend(fb_helper->fbdev, suspend);
1090}
1091EXPORT_SYMBOL(drm_fb_helper_set_suspend);
1092
1093/**
1094 * drm_fb_helper_set_suspend_unlocked - wrapper around fb_set_suspend that also
1095 *                                      takes the console lock
1096 * @fb_helper: driver-allocated fbdev helper
1097 * @suspend: whether to suspend or resume
1098 *
1099 * A wrapper around fb_set_suspend() that takes the console lock. If the lock
1100 * isn't available on resume, a worker is tasked with waiting for the lock
1101 * to become available. The console lock can be pretty contented on resume
1102 * due to all the printk activity.
1103 *
1104 * This function can be called multiple times with the same state since
1105 * &fb_info->state is checked to see if fbdev is running or not before locking.
1106 *
1107 * Use drm_fb_helper_set_suspend() if you need to take the lock yourself.
1108 */
1109void drm_fb_helper_set_suspend_unlocked(struct drm_fb_helper *fb_helper,
1110					bool suspend)
1111{
1112	if (!fb_helper || !fb_helper->fbdev)
1113		return;
1114
1115	/* make sure there's no pending/ongoing resume */
1116	flush_work(&fb_helper->resume_work);
1117
1118	if (suspend) {
1119		if (fb_helper->fbdev->state != FBINFO_STATE_RUNNING)
1120			return;
1121
1122		console_lock();
1123
1124	} else {
1125		if (fb_helper->fbdev->state == FBINFO_STATE_RUNNING)
1126			return;
1127
1128		if (!console_trylock()) {
1129			schedule_work(&fb_helper->resume_work);
1130			return;
1131		}
1132	}
1133
1134	fb_set_suspend(fb_helper->fbdev, suspend);
1135	console_unlock();
1136}
1137EXPORT_SYMBOL(drm_fb_helper_set_suspend_unlocked);
1138
1139static int setcolreg(struct drm_crtc *crtc, u16 red, u16 green,
1140		     u16 blue, u16 regno, struct fb_info *info)
1141{
1142	struct drm_fb_helper *fb_helper = info->par;
1143	struct drm_framebuffer *fb = fb_helper->fb;
 
1144
1145	if (info->fix.visual == FB_VISUAL_TRUECOLOR) {
1146		u32 *palette;
1147		u32 value;
1148		/* place color in psuedopalette */
1149		if (regno > 16)
1150			return -EINVAL;
1151		palette = (u32 *)info->pseudo_palette;
1152		red >>= (16 - info->var.red.length);
1153		green >>= (16 - info->var.green.length);
1154		blue >>= (16 - info->var.blue.length);
1155		value = (red << info->var.red.offset) |
1156			(green << info->var.green.offset) |
1157			(blue << info->var.blue.offset);
1158		if (info->var.transp.length > 0) {
1159			u32 mask = (1 << info->var.transp.length) - 1;
1160			mask <<= info->var.transp.offset;
1161			value |= mask;
1162		}
1163		palette[regno] = value;
1164		return 0;
1165	}
1166
1167	/*
1168	 * The driver really shouldn't advertise pseudo/directcolor
1169	 * visuals if it can't deal with the palette.
1170	 */
1171	if (WARN_ON(!fb_helper->funcs->gamma_set ||
1172		    !fb_helper->funcs->gamma_get))
1173		return -EINVAL;
 
 
 
 
 
 
 
 
 
 
 
1174
1175	WARN_ON(fb->bits_per_pixel != 8);
 
 
1176
1177	fb_helper->funcs->gamma_set(crtc, red, green, blue, regno);
 
 
 
 
 
1178
 
 
1179	return 0;
1180}
1181
1182/**
1183 * drm_fb_helper_setcmap - implementation for ->fb_setcmap
1184 * @cmap: cmap to set
1185 * @info: fbdev registered by the helper
1186 */
1187int drm_fb_helper_setcmap(struct fb_cmap *cmap, struct fb_info *info)
1188{
1189	struct drm_fb_helper *fb_helper = info->par;
1190	struct drm_device *dev = fb_helper->dev;
1191	const struct drm_crtc_helper_funcs *crtc_funcs;
1192	u16 *red, *green, *blue, *transp;
1193	struct drm_crtc *crtc;
1194	int i, j, rc = 0;
1195	int start;
1196
1197	if (oops_in_progress)
1198		return -EBUSY;
1199
1200	drm_modeset_lock_all(dev);
1201	if (!drm_fb_helper_is_bound(fb_helper)) {
1202		drm_modeset_unlock_all(dev);
1203		return -EBUSY;
1204	}
1205
1206	for (i = 0; i < fb_helper->crtc_count; i++) {
1207		crtc = fb_helper->crtc_info[i].mode_set.crtc;
1208		crtc_funcs = crtc->helper_private;
1209
1210		red = cmap->red;
1211		green = cmap->green;
1212		blue = cmap->blue;
1213		transp = cmap->transp;
1214		start = cmap->start;
1215
1216		for (j = 0; j < cmap->len; j++) {
1217			u16 hred, hgreen, hblue, htransp = 0xffff;
1218
1219			hred = *red++;
1220			hgreen = *green++;
1221			hblue = *blue++;
1222
1223			if (transp)
1224				htransp = *transp++;
1225
1226			rc = setcolreg(crtc, hred, hgreen, hblue, start++, info);
1227			if (rc)
1228				goto out;
1229		}
1230		if (crtc_funcs->load_lut)
1231			crtc_funcs->load_lut(crtc);
1232	}
1233 out:
1234	drm_modeset_unlock_all(dev);
1235	return rc;
1236}
1237EXPORT_SYMBOL(drm_fb_helper_setcmap);
1238
1239/**
1240 * drm_fb_helper_check_var - implementation for ->fb_check_var
1241 * @var: screeninfo to check
1242 * @info: fbdev registered by the helper
1243 */
1244int drm_fb_helper_check_var(struct fb_var_screeninfo *var,
1245			    struct fb_info *info)
1246{
1247	struct drm_fb_helper *fb_helper = info->par;
1248	struct drm_framebuffer *fb = fb_helper->fb;
1249	int depth;
1250
1251	if (var->pixclock != 0 || in_dbg_master())
1252		return -EINVAL;
1253
1254	/*
1255	 * Changes struct fb_var_screeninfo are currently not pushed back
1256	 * to KMS, hence fail if different settings are requested.
1257	 */
1258	if (var->bits_per_pixel != fb->bits_per_pixel ||
1259	    var->xres != fb->width || var->yres != fb->height ||
1260	    var->xres_virtual != fb->width || var->yres_virtual != fb->height) {
1261		DRM_DEBUG("fb userspace requested width/height/bpp different than current fb "
1262			  "request %dx%d-%d (virtual %dx%d) > %dx%d-%d\n",
1263			  var->xres, var->yres, var->bits_per_pixel,
1264			  var->xres_virtual, var->yres_virtual,
1265			  fb->width, fb->height, fb->bits_per_pixel);
1266		return -EINVAL;
1267	}
1268
1269	switch (var->bits_per_pixel) {
1270	case 16:
1271		depth = (var->green.length == 6) ? 16 : 15;
1272		break;
1273	case 32:
1274		depth = (var->transp.length > 0) ? 32 : 24;
1275		break;
1276	default:
1277		depth = var->bits_per_pixel;
1278		break;
1279	}
1280
1281	switch (depth) {
1282	case 8:
1283		var->red.offset = 0;
1284		var->green.offset = 0;
1285		var->blue.offset = 0;
1286		var->red.length = 8;
1287		var->green.length = 8;
1288		var->blue.length = 8;
1289		var->transp.length = 0;
1290		var->transp.offset = 0;
1291		break;
1292	case 15:
1293		var->red.offset = 10;
1294		var->green.offset = 5;
1295		var->blue.offset = 0;
1296		var->red.length = 5;
1297		var->green.length = 5;
1298		var->blue.length = 5;
1299		var->transp.length = 1;
1300		var->transp.offset = 15;
1301		break;
1302	case 16:
1303		var->red.offset = 11;
1304		var->green.offset = 5;
1305		var->blue.offset = 0;
1306		var->red.length = 5;
1307		var->green.length = 6;
1308		var->blue.length = 5;
1309		var->transp.length = 0;
1310		var->transp.offset = 0;
1311		break;
1312	case 24:
1313		var->red.offset = 16;
1314		var->green.offset = 8;
1315		var->blue.offset = 0;
1316		var->red.length = 8;
1317		var->green.length = 8;
1318		var->blue.length = 8;
1319		var->transp.length = 0;
1320		var->transp.offset = 0;
1321		break;
1322	case 32:
1323		var->red.offset = 16;
1324		var->green.offset = 8;
1325		var->blue.offset = 0;
1326		var->red.length = 8;
1327		var->green.length = 8;
1328		var->blue.length = 8;
1329		var->transp.length = 8;
1330		var->transp.offset = 24;
1331		break;
1332	default:
1333		return -EINVAL;
1334	}
1335	return 0;
1336}
1337EXPORT_SYMBOL(drm_fb_helper_check_var);
1338
1339/**
1340 * drm_fb_helper_set_par - implementation for ->fb_set_par
1341 * @info: fbdev registered by the helper
1342 *
1343 * This will let fbcon do the mode init and is called at initialization time by
1344 * the fbdev core when registering the driver, and later on through the hotplug
1345 * callback.
1346 */
1347int drm_fb_helper_set_par(struct fb_info *info)
1348{
1349	struct drm_fb_helper *fb_helper = info->par;
 
1350	struct fb_var_screeninfo *var = &info->var;
1351
1352	if (oops_in_progress)
1353		return -EBUSY;
1354
1355	if (var->pixclock != 0) {
1356		DRM_ERROR("PIXEL CLOCK SET\n");
1357		return -EINVAL;
1358	}
1359
1360	drm_fb_helper_restore_fbdev_mode_unlocked(fb_helper);
 
 
 
 
 
 
 
 
 
1361
 
 
 
 
1362	return 0;
1363}
1364EXPORT_SYMBOL(drm_fb_helper_set_par);
1365
1366static int pan_display_atomic(struct fb_var_screeninfo *var,
1367			      struct fb_info *info)
1368{
1369	struct drm_fb_helper *fb_helper = info->par;
1370	struct drm_device *dev = fb_helper->dev;
1371	struct drm_atomic_state *state;
1372	struct drm_plane *plane;
1373	int i, ret;
1374	unsigned plane_mask;
1375
1376	state = drm_atomic_state_alloc(dev);
1377	if (!state)
1378		return -ENOMEM;
1379
1380	state->acquire_ctx = dev->mode_config.acquire_ctx;
1381retry:
1382	plane_mask = 0;
1383	for(i = 0; i < fb_helper->crtc_count; i++) {
1384		struct drm_mode_set *mode_set;
1385
1386		mode_set = &fb_helper->crtc_info[i].mode_set;
1387
1388		mode_set->x = var->xoffset;
1389		mode_set->y = var->yoffset;
1390
1391		ret = __drm_atomic_helper_set_config(mode_set, state);
1392		if (ret != 0)
1393			goto fail;
1394
1395		plane = mode_set->crtc->primary;
1396		plane_mask |= (1 << drm_plane_index(plane));
1397		plane->old_fb = plane->fb;
1398	}
1399
1400	ret = drm_atomic_commit(state);
1401	if (ret != 0)
1402		goto fail;
1403
1404	info->var.xoffset = var->xoffset;
1405	info->var.yoffset = var->yoffset;
1406
1407fail:
1408	drm_atomic_clean_old_fb(dev, plane_mask, ret);
1409
1410	if (ret == -EDEADLK)
1411		goto backoff;
1412
1413	drm_atomic_state_put(state);
1414	return ret;
1415
1416backoff:
1417	drm_atomic_state_clear(state);
1418	drm_atomic_legacy_backoff(state);
1419
1420	goto retry;
1421}
1422
1423/**
1424 * drm_fb_helper_pan_display - implementation for ->fb_pan_display
1425 * @var: updated screen information
1426 * @info: fbdev registered by the helper
1427 */
1428int drm_fb_helper_pan_display(struct fb_var_screeninfo *var,
1429			      struct fb_info *info)
1430{
1431	struct drm_fb_helper *fb_helper = info->par;
1432	struct drm_device *dev = fb_helper->dev;
1433	struct drm_mode_set *modeset;
 
1434	int ret = 0;
1435	int i;
1436
1437	if (oops_in_progress)
1438		return -EBUSY;
1439
1440	drm_modeset_lock_all(dev);
1441	if (!drm_fb_helper_is_bound(fb_helper)) {
1442		drm_modeset_unlock_all(dev);
1443		return -EBUSY;
1444	}
1445
1446	if (dev->mode_config.funcs->atomic_commit) {
1447		ret = pan_display_atomic(var, info);
1448		goto unlock;
1449	}
1450
1451	for (i = 0; i < fb_helper->crtc_count; i++) {
1452		modeset = &fb_helper->crtc_info[i].mode_set;
1453
1454		modeset->x = var->xoffset;
1455		modeset->y = var->yoffset;
1456
1457		if (modeset->num_connectors) {
1458			ret = drm_mode_set_config_internal(modeset);
1459			if (!ret) {
1460				info->var.xoffset = var->xoffset;
1461				info->var.yoffset = var->yoffset;
1462			}
1463		}
1464	}
1465unlock:
1466	drm_modeset_unlock_all(dev);
1467	return ret;
1468}
1469EXPORT_SYMBOL(drm_fb_helper_pan_display);
1470
1471/*
1472 * Allocates the backing storage and sets up the fbdev info structure through
1473 * the ->fb_probe callback and then registers the fbdev and sets up the panic
1474 * notifier.
1475 */
1476static int drm_fb_helper_single_fb_probe(struct drm_fb_helper *fb_helper,
1477					 int preferred_bpp)
1478{
1479	int ret = 0;
1480	int crtc_count = 0;
1481	int i;
 
1482	struct drm_fb_helper_surface_size sizes;
1483	int gamma_size = 0;
1484
1485	memset(&sizes, 0, sizeof(struct drm_fb_helper_surface_size));
1486	sizes.surface_depth = 24;
1487	sizes.surface_bpp = 32;
1488	sizes.fb_width = (unsigned)-1;
1489	sizes.fb_height = (unsigned)-1;
1490
1491	/* if driver picks 8 or 16 by default use that
1492	   for both depth/bpp */
1493	if (preferred_bpp != sizes.surface_bpp)
1494		sizes.surface_depth = sizes.surface_bpp = preferred_bpp;
1495
1496	/* first up get a count of crtcs now in use and new min/maxes width/heights */
1497	drm_fb_helper_for_each_connector(fb_helper, i) {
1498		struct drm_fb_helper_connector *fb_helper_conn = fb_helper->connector_info[i];
1499		struct drm_cmdline_mode *cmdline_mode;
1500
1501		cmdline_mode = &fb_helper_conn->connector->cmdline_mode;
1502
1503		if (cmdline_mode->bpp_specified) {
1504			switch (cmdline_mode->bpp) {
1505			case 8:
1506				sizes.surface_depth = sizes.surface_bpp = 8;
1507				break;
1508			case 15:
1509				sizes.surface_depth = 15;
1510				sizes.surface_bpp = 16;
1511				break;
1512			case 16:
1513				sizes.surface_depth = sizes.surface_bpp = 16;
1514				break;
1515			case 24:
1516				sizes.surface_depth = sizes.surface_bpp = 24;
1517				break;
1518			case 32:
1519				sizes.surface_depth = 24;
1520				sizes.surface_bpp = 32;
1521				break;
1522			}
1523			break;
1524		}
1525	}
1526
1527	crtc_count = 0;
1528	for (i = 0; i < fb_helper->crtc_count; i++) {
1529		struct drm_display_mode *desired_mode;
1530		struct drm_mode_set *mode_set;
1531		int x, y, j;
1532		/* in case of tile group, are we the last tile vert or horiz?
1533		 * If no tile group you are always the last one both vertically
1534		 * and horizontally
1535		 */
1536		bool lastv = true, lasth = true;
1537
1538		desired_mode = fb_helper->crtc_info[i].desired_mode;
1539		mode_set = &fb_helper->crtc_info[i].mode_set;
1540
1541		if (!desired_mode)
1542			continue;
1543
1544		crtc_count++;
1545
1546		x = fb_helper->crtc_info[i].x;
1547		y = fb_helper->crtc_info[i].y;
1548
1549		if (gamma_size == 0)
1550			gamma_size = fb_helper->crtc_info[i].mode_set.crtc->gamma_size;
1551
1552		sizes.surface_width  = max_t(u32, desired_mode->hdisplay + x, sizes.surface_width);
1553		sizes.surface_height = max_t(u32, desired_mode->vdisplay + y, sizes.surface_height);
1554
1555		for (j = 0; j < mode_set->num_connectors; j++) {
1556			struct drm_connector *connector = mode_set->connectors[j];
1557			if (connector->has_tile) {
1558				lasth = (connector->tile_h_loc == (connector->num_h_tile - 1));
1559				lastv = (connector->tile_v_loc == (connector->num_v_tile - 1));
1560				/* cloning to multiple tiles is just crazy-talk, so: */
1561				break;
1562			}
1563		}
1564
1565		if (lasth)
1566			sizes.fb_width  = min_t(u32, desired_mode->hdisplay + x, sizes.fb_width);
1567		if (lastv)
1568			sizes.fb_height = min_t(u32, desired_mode->vdisplay + y, sizes.fb_height);
1569	}
1570
1571	if (crtc_count == 0 || sizes.fb_width == -1 || sizes.fb_height == -1) {
1572		/* hmm everyone went away - assume VGA cable just fell out
1573		   and will come back later. */
1574		DRM_INFO("Cannot find any crtc or sizes - going 1024x768\n");
1575		sizes.fb_width = sizes.surface_width = 1024;
1576		sizes.fb_height = sizes.surface_height = 768;
1577	}
1578
1579	/* push down into drivers */
1580	ret = (*fb_helper->funcs->fb_probe)(fb_helper, &sizes);
1581	if (ret < 0)
1582		return ret;
1583
1584	/*
1585	 * Set the fb pointer - usually drm_setup_crtcs does this for hotplug
1586	 * events, but at init time drm_setup_crtcs needs to be called before
1587	 * the fb is allocated (since we need to figure out the desired size of
1588	 * the fb before we can allocate it ...). Hence we need to fix things up
1589	 * here again.
1590	 */
1591	for (i = 0; i < fb_helper->crtc_count; i++)
1592		if (fb_helper->crtc_info[i].mode_set.num_connectors)
1593			fb_helper->crtc_info[i].mode_set.fb = fb_helper->fb;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1594
1595	return 0;
1596}
 
1597
1598/**
1599 * drm_fb_helper_fill_fix - initializes fixed fbdev information
1600 * @info: fbdev registered by the helper
1601 * @pitch: desired pitch
1602 * @depth: desired depth
1603 *
1604 * Helper to fill in the fixed fbdev information useful for a non-accelerated
1605 * fbdev emulations. Drivers which support acceleration methods which impose
1606 * additional constraints need to set up their own limits.
1607 *
1608 * Drivers should call this (or their equivalent setup code) from their
1609 * ->fb_probe callback.
1610 */
1611void drm_fb_helper_fill_fix(struct fb_info *info, uint32_t pitch,
1612			    uint32_t depth)
1613{
1614	info->fix.type = FB_TYPE_PACKED_PIXELS;
1615	info->fix.visual = depth == 8 ? FB_VISUAL_PSEUDOCOLOR :
1616		FB_VISUAL_TRUECOLOR;
1617	info->fix.mmio_start = 0;
1618	info->fix.mmio_len = 0;
1619	info->fix.type_aux = 0;
1620	info->fix.xpanstep = 1; /* doing it in hw */
1621	info->fix.ypanstep = 1; /* doing it in hw */
1622	info->fix.ywrapstep = 0;
1623	info->fix.accel = FB_ACCEL_NONE;
 
1624
1625	info->fix.line_length = pitch;
1626	return;
1627}
1628EXPORT_SYMBOL(drm_fb_helper_fill_fix);
1629
1630/**
1631 * drm_fb_helper_fill_var - initalizes variable fbdev information
1632 * @info: fbdev instance to set up
1633 * @fb_helper: fb helper instance to use as template
1634 * @fb_width: desired fb width
1635 * @fb_height: desired fb height
1636 *
1637 * Sets up the variable fbdev metainformation from the given fb helper instance
1638 * and the drm framebuffer allocated in fb_helper->fb.
1639 *
1640 * Drivers should call this (or their equivalent setup code) from their
1641 * ->fb_probe callback after having allocated the fbdev backing
1642 * storage framebuffer.
1643 */
1644void drm_fb_helper_fill_var(struct fb_info *info, struct drm_fb_helper *fb_helper,
1645			    uint32_t fb_width, uint32_t fb_height)
1646{
1647	struct drm_framebuffer *fb = fb_helper->fb;
1648	info->pseudo_palette = fb_helper->pseudo_palette;
1649	info->var.xres_virtual = fb->width;
1650	info->var.yres_virtual = fb->height;
1651	info->var.bits_per_pixel = fb->bits_per_pixel;
1652	info->var.accel_flags = FB_ACCELF_TEXT;
1653	info->var.xoffset = 0;
1654	info->var.yoffset = 0;
1655	info->var.activate = FB_ACTIVATE_NOW;
1656	info->var.height = -1;
1657	info->var.width = -1;
1658
1659	switch (fb->depth) {
1660	case 8:
1661		info->var.red.offset = 0;
1662		info->var.green.offset = 0;
1663		info->var.blue.offset = 0;
1664		info->var.red.length = 8; /* 8bit DAC */
1665		info->var.green.length = 8;
1666		info->var.blue.length = 8;
1667		info->var.transp.offset = 0;
1668		info->var.transp.length = 0;
1669		break;
1670	case 15:
1671		info->var.red.offset = 10;
1672		info->var.green.offset = 5;
1673		info->var.blue.offset = 0;
1674		info->var.red.length = 5;
1675		info->var.green.length = 5;
1676		info->var.blue.length = 5;
1677		info->var.transp.offset = 15;
1678		info->var.transp.length = 1;
1679		break;
1680	case 16:
1681		info->var.red.offset = 11;
1682		info->var.green.offset = 5;
1683		info->var.blue.offset = 0;
1684		info->var.red.length = 5;
1685		info->var.green.length = 6;
1686		info->var.blue.length = 5;
1687		info->var.transp.offset = 0;
1688		break;
1689	case 24:
1690		info->var.red.offset = 16;
1691		info->var.green.offset = 8;
1692		info->var.blue.offset = 0;
1693		info->var.red.length = 8;
1694		info->var.green.length = 8;
1695		info->var.blue.length = 8;
1696		info->var.transp.offset = 0;
1697		info->var.transp.length = 0;
1698		break;
1699	case 32:
1700		info->var.red.offset = 16;
1701		info->var.green.offset = 8;
1702		info->var.blue.offset = 0;
1703		info->var.red.length = 8;
1704		info->var.green.length = 8;
1705		info->var.blue.length = 8;
1706		info->var.transp.offset = 24;
1707		info->var.transp.length = 8;
1708		break;
1709	default:
1710		break;
1711	}
1712
1713	info->var.xres = fb_width;
1714	info->var.yres = fb_height;
1715}
1716EXPORT_SYMBOL(drm_fb_helper_fill_var);
1717
1718static int drm_fb_helper_probe_connector_modes(struct drm_fb_helper *fb_helper,
1719					       uint32_t maxX,
1720					       uint32_t maxY)
1721{
1722	struct drm_connector *connector;
1723	int count = 0;
1724	int i;
1725
1726	drm_fb_helper_for_each_connector(fb_helper, i) {
1727		connector = fb_helper->connector_info[i]->connector;
1728		count += connector->funcs->fill_modes(connector, maxX, maxY);
1729	}
1730
1731	return count;
1732}
1733
1734struct drm_display_mode *drm_has_preferred_mode(struct drm_fb_helper_connector *fb_connector, int width, int height)
1735{
1736	struct drm_display_mode *mode;
1737
1738	list_for_each_entry(mode, &fb_connector->connector->modes, head) {
1739		if (mode->hdisplay > width ||
1740		    mode->vdisplay > height)
1741			continue;
1742		if (mode->type & DRM_MODE_TYPE_PREFERRED)
1743			return mode;
1744	}
1745	return NULL;
1746}
1747EXPORT_SYMBOL(drm_has_preferred_mode);
1748
1749static bool drm_has_cmdline_mode(struct drm_fb_helper_connector *fb_connector)
1750{
1751	return fb_connector->connector->cmdline_mode.specified;
 
 
1752}
1753
1754struct drm_display_mode *drm_pick_cmdline_mode(struct drm_fb_helper_connector *fb_helper_conn,
1755						      int width, int height)
1756{
1757	struct drm_cmdline_mode *cmdline_mode;
1758	struct drm_display_mode *mode;
1759	bool prefer_non_interlace;
1760
1761	cmdline_mode = &fb_helper_conn->connector->cmdline_mode;
1762	if (cmdline_mode->specified == false)
1763		return NULL;
1764
1765	/* attempt to find a matching mode in the list of modes
1766	 *  we have gotten so far, if not add a CVT mode that conforms
1767	 */
1768	if (cmdline_mode->rb || cmdline_mode->margins)
1769		goto create_mode;
1770
1771	prefer_non_interlace = !cmdline_mode->interlace;
1772again:
1773	list_for_each_entry(mode, &fb_helper_conn->connector->modes, head) {
1774		/* check width/height */
1775		if (mode->hdisplay != cmdline_mode->xres ||
1776		    mode->vdisplay != cmdline_mode->yres)
1777			continue;
1778
1779		if (cmdline_mode->refresh_specified) {
1780			if (mode->vrefresh != cmdline_mode->refresh)
1781				continue;
1782		}
1783
1784		if (cmdline_mode->interlace) {
1785			if (!(mode->flags & DRM_MODE_FLAG_INTERLACE))
1786				continue;
1787		} else if (prefer_non_interlace) {
1788			if (mode->flags & DRM_MODE_FLAG_INTERLACE)
1789				continue;
1790		}
1791		return mode;
1792	}
1793
1794	if (prefer_non_interlace) {
1795		prefer_non_interlace = false;
1796		goto again;
1797	}
1798
1799create_mode:
1800	mode = drm_mode_create_from_cmdline_mode(fb_helper_conn->connector->dev,
1801						 cmdline_mode);
1802	list_add(&mode->head, &fb_helper_conn->connector->modes);
1803	return mode;
1804}
1805EXPORT_SYMBOL(drm_pick_cmdline_mode);
1806
1807static bool drm_connector_enabled(struct drm_connector *connector, bool strict)
1808{
1809	bool enable;
1810
1811	if (strict)
1812		enable = connector->status == connector_status_connected;
1813	else
1814		enable = connector->status != connector_status_disconnected;
1815
1816	return enable;
1817}
1818
1819static void drm_enable_connectors(struct drm_fb_helper *fb_helper,
1820				  bool *enabled)
1821{
1822	bool any_enabled = false;
1823	struct drm_connector *connector;
1824	int i = 0;
1825
1826	drm_fb_helper_for_each_connector(fb_helper, i) {
1827		connector = fb_helper->connector_info[i]->connector;
1828		enabled[i] = drm_connector_enabled(connector, true);
1829		DRM_DEBUG_KMS("connector %d enabled? %s\n", connector->base.id,
1830			  enabled[i] ? "yes" : "no");
1831		any_enabled |= enabled[i];
1832	}
1833
1834	if (any_enabled)
1835		return;
1836
1837	drm_fb_helper_for_each_connector(fb_helper, i) {
1838		connector = fb_helper->connector_info[i]->connector;
1839		enabled[i] = drm_connector_enabled(connector, false);
1840	}
1841}
1842
1843static bool drm_target_cloned(struct drm_fb_helper *fb_helper,
1844			      struct drm_display_mode **modes,
1845			      struct drm_fb_offset *offsets,
1846			      bool *enabled, int width, int height)
1847{
1848	int count, i, j;
1849	bool can_clone = false;
1850	struct drm_fb_helper_connector *fb_helper_conn;
1851	struct drm_display_mode *dmt_mode, *mode;
1852
1853	/* only contemplate cloning in the single crtc case */
1854	if (fb_helper->crtc_count > 1)
1855		return false;
1856
1857	count = 0;
1858	drm_fb_helper_for_each_connector(fb_helper, i) {
1859		if (enabled[i])
1860			count++;
1861	}
1862
1863	/* only contemplate cloning if more than one connector is enabled */
1864	if (count <= 1)
1865		return false;
1866
1867	/* check the command line or if nothing common pick 1024x768 */
1868	can_clone = true;
1869	drm_fb_helper_for_each_connector(fb_helper, i) {
1870		if (!enabled[i])
1871			continue;
1872		fb_helper_conn = fb_helper->connector_info[i];
1873		modes[i] = drm_pick_cmdline_mode(fb_helper_conn, width, height);
1874		if (!modes[i]) {
1875			can_clone = false;
1876			break;
1877		}
1878		for (j = 0; j < i; j++) {
1879			if (!enabled[j])
1880				continue;
1881			if (!drm_mode_equal(modes[j], modes[i]))
1882				can_clone = false;
1883		}
1884	}
1885
1886	if (can_clone) {
1887		DRM_DEBUG_KMS("can clone using command line\n");
1888		return true;
1889	}
1890
1891	/* try and find a 1024x768 mode on each connector */
1892	can_clone = true;
1893	dmt_mode = drm_mode_find_dmt(fb_helper->dev, 1024, 768, 60, false);
 
 
1894
1895	drm_fb_helper_for_each_connector(fb_helper, i) {
1896		if (!enabled[i])
1897			continue;
1898
1899		fb_helper_conn = fb_helper->connector_info[i];
1900		list_for_each_entry(mode, &fb_helper_conn->connector->modes, head) {
1901			if (drm_mode_equal(mode, dmt_mode))
1902				modes[i] = mode;
1903		}
1904		if (!modes[i])
1905			can_clone = false;
1906	}
1907
1908	if (can_clone) {
1909		DRM_DEBUG_KMS("can clone using 1024x768\n");
1910		return true;
1911	}
1912	DRM_INFO("kms: can't enable cloning when we probably wanted to.\n");
1913	return false;
1914}
1915
1916static int drm_get_tile_offsets(struct drm_fb_helper *fb_helper,
1917				struct drm_display_mode **modes,
1918				struct drm_fb_offset *offsets,
1919				int idx,
1920				int h_idx, int v_idx)
1921{
1922	struct drm_fb_helper_connector *fb_helper_conn;
1923	int i;
1924	int hoffset = 0, voffset = 0;
1925
1926	drm_fb_helper_for_each_connector(fb_helper, i) {
1927		fb_helper_conn = fb_helper->connector_info[i];
1928		if (!fb_helper_conn->connector->has_tile)
1929			continue;
1930
1931		if (!modes[i] && (h_idx || v_idx)) {
1932			DRM_DEBUG_KMS("no modes for connector tiled %d %d\n", i,
1933				      fb_helper_conn->connector->base.id);
1934			continue;
1935		}
1936		if (fb_helper_conn->connector->tile_h_loc < h_idx)
1937			hoffset += modes[i]->hdisplay;
1938
1939		if (fb_helper_conn->connector->tile_v_loc < v_idx)
1940			voffset += modes[i]->vdisplay;
1941	}
1942	offsets[idx].x = hoffset;
1943	offsets[idx].y = voffset;
1944	DRM_DEBUG_KMS("returned %d %d for %d %d\n", hoffset, voffset, h_idx, v_idx);
1945	return 0;
1946}
1947
1948static bool drm_target_preferred(struct drm_fb_helper *fb_helper,
1949				 struct drm_display_mode **modes,
1950				 struct drm_fb_offset *offsets,
1951				 bool *enabled, int width, int height)
1952{
1953	struct drm_fb_helper_connector *fb_helper_conn;
1954	const u64 mask = BIT_ULL(fb_helper->connector_count) - 1;
1955	u64 conn_configured = 0;
1956	int tile_pass = 0;
1957	int i;
1958
1959retry:
1960	drm_fb_helper_for_each_connector(fb_helper, i) {
1961		fb_helper_conn = fb_helper->connector_info[i];
1962
1963		if (conn_configured & BIT_ULL(i))
1964			continue;
1965
1966		if (enabled[i] == false) {
1967			conn_configured |= BIT_ULL(i);
1968			continue;
1969		}
1970
1971		/* first pass over all the untiled connectors */
1972		if (tile_pass == 0 && fb_helper_conn->connector->has_tile)
1973			continue;
1974
1975		if (tile_pass == 1) {
1976			if (fb_helper_conn->connector->tile_h_loc != 0 ||
1977			    fb_helper_conn->connector->tile_v_loc != 0)
1978				continue;
1979
1980		} else {
1981			if (fb_helper_conn->connector->tile_h_loc != tile_pass -1 &&
1982			    fb_helper_conn->connector->tile_v_loc != tile_pass - 1)
1983			/* if this tile_pass doesn't cover any of the tiles - keep going */
1984				continue;
1985
1986			/* find the tile offsets for this pass - need
1987			   to find all tiles left and above */
1988			drm_get_tile_offsets(fb_helper, modes, offsets,
1989					     i, fb_helper_conn->connector->tile_h_loc, fb_helper_conn->connector->tile_v_loc);
1990		}
1991		DRM_DEBUG_KMS("looking for cmdline mode on connector %d\n",
1992			      fb_helper_conn->connector->base.id);
1993
1994		/* got for command line mode first */
1995		modes[i] = drm_pick_cmdline_mode(fb_helper_conn, width, height);
1996		if (!modes[i]) {
1997			DRM_DEBUG_KMS("looking for preferred mode on connector %d %d\n",
1998				      fb_helper_conn->connector->base.id, fb_helper_conn->connector->tile_group ? fb_helper_conn->connector->tile_group->id : 0);
1999			modes[i] = drm_has_preferred_mode(fb_helper_conn, width, height);
2000		}
2001		/* No preferred modes, pick one off the list */
2002		if (!modes[i] && !list_empty(&fb_helper_conn->connector->modes)) {
2003			list_for_each_entry(modes[i], &fb_helper_conn->connector->modes, head)
2004				break;
2005		}
2006		DRM_DEBUG_KMS("found mode %s\n", modes[i] ? modes[i]->name :
2007			  "none");
2008		conn_configured |= BIT_ULL(i);
2009	}
2010
2011	if ((conn_configured & mask) != mask) {
2012		tile_pass++;
2013		goto retry;
2014	}
2015	return true;
2016}
2017
2018static int drm_pick_crtcs(struct drm_fb_helper *fb_helper,
2019			  struct drm_fb_helper_crtc **best_crtcs,
2020			  struct drm_display_mode **modes,
2021			  int n, int width, int height)
2022{
2023	int c, o;
 
2024	struct drm_connector *connector;
2025	const struct drm_connector_helper_funcs *connector_funcs;
2026	struct drm_encoder *encoder;
 
2027	int my_score, best_score, score;
2028	struct drm_fb_helper_crtc **crtcs, *crtc;
2029	struct drm_fb_helper_connector *fb_helper_conn;
2030
2031	if (n == fb_helper->connector_count)
2032		return 0;
2033
2034	fb_helper_conn = fb_helper->connector_info[n];
2035	connector = fb_helper_conn->connector;
2036
2037	best_crtcs[n] = NULL;
 
2038	best_score = drm_pick_crtcs(fb_helper, best_crtcs, modes, n+1, width, height);
2039	if (modes[n] == NULL)
2040		return best_score;
2041
2042	crtcs = kzalloc(fb_helper->connector_count *
2043			sizeof(struct drm_fb_helper_crtc *), GFP_KERNEL);
2044	if (!crtcs)
2045		return best_score;
2046
2047	my_score = 1;
2048	if (connector->status == connector_status_connected)
2049		my_score++;
2050	if (drm_has_cmdline_mode(fb_helper_conn))
2051		my_score++;
2052	if (drm_has_preferred_mode(fb_helper_conn, width, height))
2053		my_score++;
2054
2055	connector_funcs = connector->helper_private;
2056
2057	/*
2058	 * If the DRM device implements atomic hooks and ->best_encoder() is
2059	 * NULL we fallback to the default drm_atomic_helper_best_encoder()
2060	 * helper.
2061	 */
2062	if (fb_helper->dev->mode_config.funcs->atomic_commit &&
2063	    !connector_funcs->best_encoder)
2064		encoder = drm_atomic_helper_best_encoder(connector);
2065	else
2066		encoder = connector_funcs->best_encoder(connector);
2067
2068	if (!encoder)
2069		goto out;
2070
2071	/* select a crtc for this connector and then attempt to configure
2072	   remaining connectors */
2073	for (c = 0; c < fb_helper->crtc_count; c++) {
2074		crtc = &fb_helper->crtc_info[c];
2075
2076		if ((encoder->possible_crtcs & (1 << c)) == 0)
2077			continue;
 
2078
2079		for (o = 0; o < n; o++)
2080			if (best_crtcs[o] == crtc)
2081				break;
2082
2083		if (o < n) {
2084			/* ignore cloning unless only a single crtc */
2085			if (fb_helper->crtc_count > 1)
2086				continue;
2087
2088			if (!drm_mode_equal(modes[o], modes[n]))
2089				continue;
2090		}
2091
2092		crtcs[n] = crtc;
2093		memcpy(crtcs, best_crtcs, n * sizeof(struct drm_fb_helper_crtc *));
2094		score = my_score + drm_pick_crtcs(fb_helper, crtcs, modes, n + 1,
2095						  width, height);
2096		if (score > best_score) {
 
2097			best_score = score;
2098			memcpy(best_crtcs, crtcs,
2099			       fb_helper->connector_count *
2100			       sizeof(struct drm_fb_helper_crtc *));
2101		}
2102	}
2103out:
2104	kfree(crtcs);
2105	return best_score;
2106}
2107
2108static void drm_setup_crtcs(struct drm_fb_helper *fb_helper,
2109			    u32 width, u32 height)
2110{
2111	struct drm_device *dev = fb_helper->dev;
2112	struct drm_fb_helper_crtc **crtcs;
2113	struct drm_display_mode **modes;
2114	struct drm_fb_offset *offsets;
 
2115	bool *enabled;
2116	int i;
 
2117
2118	DRM_DEBUG_KMS("\n");
2119	if (drm_fb_helper_probe_connector_modes(fb_helper, width, height) == 0)
2120		DRM_DEBUG_KMS("No connectors reported connected with modes\n");
2121
2122	/* prevent concurrent modification of connector_count by hotplug */
2123	lockdep_assert_held(&fb_helper->dev->mode_config.mutex);
2124
2125	crtcs = kcalloc(fb_helper->connector_count,
 
 
 
 
 
2126			sizeof(struct drm_fb_helper_crtc *), GFP_KERNEL);
2127	modes = kcalloc(fb_helper->connector_count,
2128			sizeof(struct drm_display_mode *), GFP_KERNEL);
2129	offsets = kcalloc(fb_helper->connector_count,
2130			  sizeof(struct drm_fb_offset), GFP_KERNEL);
2131	enabled = kcalloc(fb_helper->connector_count,
2132			  sizeof(bool), GFP_KERNEL);
2133	if (!crtcs || !modes || !enabled || !offsets) {
2134		DRM_ERROR("Memory allocation failed\n");
2135		goto out;
2136	}
2137
2138	drm_enable_connectors(fb_helper, enabled);
2139
2140	if (!(fb_helper->funcs->initial_config &&
2141	      fb_helper->funcs->initial_config(fb_helper, crtcs, modes,
2142					       offsets,
2143					       enabled, width, height))) {
2144		memset(modes, 0, fb_helper->connector_count*sizeof(modes[0]));
2145		memset(crtcs, 0, fb_helper->connector_count*sizeof(crtcs[0]));
2146		memset(offsets, 0, fb_helper->connector_count*sizeof(offsets[0]));
2147
2148		if (!drm_target_cloned(fb_helper, modes, offsets,
2149				       enabled, width, height) &&
2150		    !drm_target_preferred(fb_helper, modes, offsets,
2151					  enabled, width, height))
2152			DRM_ERROR("Unable to find initial modes\n");
 
2153
2154		DRM_DEBUG_KMS("picking CRTCs for %dx%d config\n",
2155			      width, height);
2156
2157		drm_pick_crtcs(fb_helper, crtcs, modes, 0, width, height);
2158	}
2159
2160	/* need to set the modesets up here for use later */
2161	/* fill out the connector<->crtc mappings into the modesets */
2162	for (i = 0; i < fb_helper->crtc_count; i++)
2163		drm_fb_helper_modeset_release(fb_helper,
2164					      &fb_helper->crtc_info[i].mode_set);
 
2165
2166	drm_fb_helper_for_each_connector(fb_helper, i) {
2167		struct drm_display_mode *mode = modes[i];
2168		struct drm_fb_helper_crtc *fb_crtc = crtcs[i];
2169		struct drm_fb_offset *offset = &offsets[i];
2170		struct drm_mode_set *modeset = &fb_crtc->mode_set;
2171
2172		if (mode && fb_crtc) {
2173			struct drm_connector *connector =
2174				fb_helper->connector_info[i]->connector;
2175
2176			DRM_DEBUG_KMS("desired mode %s set on crtc %d (%d,%d)\n",
2177				      mode->name, fb_crtc->mode_set.crtc->base.id, offset->x, offset->y);
2178
2179			fb_crtc->desired_mode = mode;
2180			fb_crtc->x = offset->x;
2181			fb_crtc->y = offset->y;
2182			modeset->mode = drm_mode_duplicate(dev,
2183							   fb_crtc->desired_mode);
2184			drm_connector_reference(connector);
2185			modeset->connectors[modeset->num_connectors++] = connector;
2186			modeset->fb = fb_helper->fb;
2187			modeset->x = offset->x;
2188			modeset->y = offset->y;
2189		}
2190	}
2191out:
2192	kfree(crtcs);
2193	kfree(modes);
2194	kfree(offsets);
2195	kfree(enabled);
2196}
2197
2198/**
2199 * drm_fb_helper_initial_config - setup a sane initial connector configuration
2200 * @fb_helper: fb_helper device struct
2201 * @bpp_sel: bpp value to use for the framebuffer configuration
 
 
2202 *
2203 * Scans the CRTCs and connectors and tries to put together an initial setup.
2204 * At the moment, this is a cloned configuration across all heads with
2205 * a new framebuffer object as the backing store.
2206 *
2207 * Note that this also registers the fbdev and so allows userspace to call into
2208 * the driver through the fbdev interfaces.
2209 *
2210 * This function will call down into the ->fb_probe callback to let
2211 * the driver allocate and initialize the fbdev info structure and the drm
2212 * framebuffer used to back the fbdev. drm_fb_helper_fill_var() and
2213 * drm_fb_helper_fill_fix() are provided as helpers to setup simple default
2214 * values for the fbdev info structure.
2215 *
2216 * HANG DEBUGGING:
2217 *
2218 * When you have fbcon support built-in or already loaded, this function will do
2219 * a full modeset to setup the fbdev console. Due to locking misdesign in the
2220 * VT/fbdev subsystem that entire modeset sequence has to be done while holding
2221 * console_lock. Until console_unlock is called no dmesg lines will be sent out
2222 * to consoles, not even serial console. This means when your driver crashes,
2223 * you will see absolutely nothing else but a system stuck in this function,
2224 * with no further output. Any kind of printk() you place within your own driver
2225 * or in the drm core modeset code will also never show up.
2226 *
2227 * Standard debug practice is to run the fbcon setup without taking the
2228 * console_lock as a hack, to be able to see backtraces and crashes on the
2229 * serial line. This can be done by setting the fb.lockless_register_fb=1 kernel
2230 * cmdline option.
2231 *
2232 * The other option is to just disable fbdev emulation since very likely the
2233 * first modeset from userspace will crash in the same way, and is even easier
2234 * to debug. This can be done by setting the drm_kms_helper.fbdev_emulation=0
2235 * kernel cmdline option.
2236 *
2237 * RETURNS:
2238 * Zero if everything went ok, nonzero otherwise.
2239 */
2240int drm_fb_helper_initial_config(struct drm_fb_helper *fb_helper, int bpp_sel)
2241{
2242	struct drm_device *dev = fb_helper->dev;
2243	struct fb_info *info;
2244	int ret;
2245
2246	if (!drm_fbdev_emulation)
2247		return 0;
2248
2249	mutex_lock(&dev->mode_config.mutex);
2250	drm_setup_crtcs(fb_helper,
2251			dev->mode_config.max_width,
2252			dev->mode_config.max_height);
2253	ret = drm_fb_helper_single_fb_probe(fb_helper, bpp_sel);
2254	mutex_unlock(&dev->mode_config.mutex);
2255	if (ret)
2256		return ret;
2257
2258	info = fb_helper->fbdev;
2259	info->var.pixclock = 0;
2260	ret = register_framebuffer(info);
2261	if (ret < 0)
2262		return ret;
2263
2264	dev_info(dev->dev, "fb%d: %s frame buffer device\n",
2265		 info->node, info->fix.id);
 
 
2266
2267	mutex_lock(&kernel_fb_helper_lock);
2268	if (list_empty(&kernel_fb_helper_list))
2269		register_sysrq_key('v', &sysrq_drm_fb_helper_restore_op);
2270
2271	list_add(&fb_helper->kernel_fb_list, &kernel_fb_helper_list);
2272	mutex_unlock(&kernel_fb_helper_lock);
2273
2274	return 0;
2275}
2276EXPORT_SYMBOL(drm_fb_helper_initial_config);
2277
2278/**
2279 * drm_fb_helper_hotplug_event - respond to a hotplug notification by
2280 *                               probing all the outputs attached to the fb
2281 * @fb_helper: the drm_fb_helper
2282 *
 
 
 
2283 * Scan the connectors attached to the fb_helper and try to put together a
2284 * setup after notification of a change in output configuration.
2285 *
2286 * Called at runtime, takes the mode config locks to be able to check/change the
2287 * modeset configuration. Must be run from process context (which usually means
2288 * either the output polling work or a work item launched from the driver's
2289 * hotplug interrupt).
2290 *
2291 * Note that drivers may call this even before calling
2292 * drm_fb_helper_initial_config but only after drm_fb_helper_init. This allows
2293 * for a race-free fbcon setup and will make sure that the fbdev emulation will
2294 * not miss any hotplug events.
2295 *
2296 * RETURNS:
2297 * 0 on success and a non-zero error code otherwise.
2298 */
2299int drm_fb_helper_hotplug_event(struct drm_fb_helper *fb_helper)
2300{
2301	struct drm_device *dev = fb_helper->dev;
 
 
 
 
2302
2303	if (!drm_fbdev_emulation)
2304		return 0;
2305
2306	mutex_lock(&dev->mode_config.mutex);
2307	if (!fb_helper->fb || !drm_fb_helper_is_bound(fb_helper)) {
 
 
 
 
 
 
 
2308		fb_helper->delayed_hotplug = true;
2309		mutex_unlock(&dev->mode_config.mutex);
2310		return 0;
2311	}
2312	DRM_DEBUG_KMS("\n");
2313
2314	drm_setup_crtcs(fb_helper, fb_helper->fb->width, fb_helper->fb->height);
2315
 
 
 
 
 
2316	mutex_unlock(&dev->mode_config.mutex);
2317
2318	drm_fb_helper_set_par(fb_helper->fbdev);
2319
2320	return 0;
2321}
2322EXPORT_SYMBOL(drm_fb_helper_hotplug_event);
2323
2324/* The Kconfig DRM_KMS_HELPER selects FRAMEBUFFER_CONSOLE (if !EXPERT)
2325 * but the module doesn't depend on any fb console symbols.  At least
2326 * attempt to load fbcon to avoid leaving the system without a usable console.
2327 */
2328int __init drm_fb_helper_modinit(void)
 
2329{
2330#if defined(CONFIG_FRAMEBUFFER_CONSOLE_MODULE) && !defined(CONFIG_EXPERT)
2331	const char *name = "fbcon";
2332	struct module *fbcon;
2333
2334	mutex_lock(&module_mutex);
2335	fbcon = find_module(name);
2336	mutex_unlock(&module_mutex);
2337
2338	if (!fbcon)
2339		request_module_nowait(name);
2340#endif
2341	return 0;
2342}
2343EXPORT_SYMBOL(drm_fb_helper_modinit);