xref: /openbmc/linux/drivers/gpu/drm/drm_crtc.c (revision d9fd5a71)
1 /*
2  * Copyright (c) 2006-2008 Intel Corporation
3  * Copyright (c) 2007 Dave Airlie <airlied@linux.ie>
4  * Copyright (c) 2008 Red Hat Inc.
5  *
6  * DRM core CRTC related 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  *      Keith Packard
28  *	Eric Anholt <eric@anholt.net>
29  *      Dave Airlie <airlied@linux.ie>
30  *      Jesse Barnes <jesse.barnes@intel.com>
31  */
32 #include <linux/ctype.h>
33 #include <linux/list.h>
34 #include <linux/slab.h>
35 #include <linux/export.h>
36 #include <linux/dma-fence.h>
37 #include <linux/uaccess.h>
38 #include <drm/drm_crtc.h>
39 #include <drm/drm_edid.h>
40 #include <drm/drm_fourcc.h>
41 #include <drm/drm_managed.h>
42 #include <drm/drm_modeset_lock.h>
43 #include <drm/drm_atomic.h>
44 #include <drm/drm_auth.h>
45 #include <drm/drm_debugfs_crc.h>
46 #include <drm/drm_drv.h>
47 #include <drm/drm_print.h>
48 #include <drm/drm_file.h>
49 
50 #include "drm_crtc_internal.h"
51 #include "drm_internal.h"
52 
53 /**
54  * DOC: overview
55  *
56  * A CRTC represents the overall display pipeline. It receives pixel data from
57  * &drm_plane and blends them together. The &drm_display_mode is also attached
58  * to the CRTC, specifying display timings. On the output side the data is fed
59  * to one or more &drm_encoder, which are then each connected to one
60  * &drm_connector.
61  *
62  * To create a CRTC, a KMS drivers allocates and zeroes an instances of
63  * &struct drm_crtc (possibly as part of a larger structure) and registers it
64  * with a call to drm_crtc_init_with_planes().
65  *
66  * The CRTC is also the entry point for legacy modeset operations, see
67  * &drm_crtc_funcs.set_config, legacy plane operations, see
68  * &drm_crtc_funcs.page_flip and &drm_crtc_funcs.cursor_set2, and other legacy
69  * operations like &drm_crtc_funcs.gamma_set. For atomic drivers all these
70  * features are controlled through &drm_property and
71  * &drm_mode_config_funcs.atomic_check.
72  */
73 
74 /**
75  * drm_crtc_from_index - find the registered CRTC at an index
76  * @dev: DRM device
77  * @idx: index of registered CRTC to find for
78  *
79  * Given a CRTC index, return the registered CRTC from DRM device's
80  * list of CRTCs with matching index. This is the inverse of drm_crtc_index().
81  * It's useful in the vblank callbacks (like &drm_driver.enable_vblank or
82  * &drm_driver.disable_vblank), since that still deals with indices instead
83  * of pointers to &struct drm_crtc."
84  */
85 struct drm_crtc *drm_crtc_from_index(struct drm_device *dev, int idx)
86 {
87 	struct drm_crtc *crtc;
88 
89 	drm_for_each_crtc(crtc, dev)
90 		if (idx == crtc->index)
91 			return crtc;
92 
93 	return NULL;
94 }
95 EXPORT_SYMBOL(drm_crtc_from_index);
96 
97 int drm_crtc_force_disable(struct drm_crtc *crtc)
98 {
99 	struct drm_mode_set set = {
100 		.crtc = crtc,
101 	};
102 
103 	WARN_ON(drm_drv_uses_atomic_modeset(crtc->dev));
104 
105 	return drm_mode_set_config_internal(&set);
106 }
107 
108 static unsigned int drm_num_crtcs(struct drm_device *dev)
109 {
110 	unsigned int num = 0;
111 	struct drm_crtc *tmp;
112 
113 	drm_for_each_crtc(tmp, dev) {
114 		num++;
115 	}
116 
117 	return num;
118 }
119 
120 int drm_crtc_register_all(struct drm_device *dev)
121 {
122 	struct drm_crtc *crtc;
123 	int ret = 0;
124 
125 	drm_for_each_crtc(crtc, dev) {
126 		drm_debugfs_crtc_add(crtc);
127 
128 		if (crtc->funcs->late_register)
129 			ret = crtc->funcs->late_register(crtc);
130 		if (ret)
131 			return ret;
132 	}
133 
134 	return 0;
135 }
136 
137 void drm_crtc_unregister_all(struct drm_device *dev)
138 {
139 	struct drm_crtc *crtc;
140 
141 	drm_for_each_crtc(crtc, dev) {
142 		if (crtc->funcs->early_unregister)
143 			crtc->funcs->early_unregister(crtc);
144 		drm_debugfs_crtc_remove(crtc);
145 	}
146 }
147 
148 static int drm_crtc_crc_init(struct drm_crtc *crtc)
149 {
150 #ifdef CONFIG_DEBUG_FS
151 	spin_lock_init(&crtc->crc.lock);
152 	init_waitqueue_head(&crtc->crc.wq);
153 	crtc->crc.source = kstrdup("auto", GFP_KERNEL);
154 	if (!crtc->crc.source)
155 		return -ENOMEM;
156 #endif
157 	return 0;
158 }
159 
160 static void drm_crtc_crc_fini(struct drm_crtc *crtc)
161 {
162 #ifdef CONFIG_DEBUG_FS
163 	kfree(crtc->crc.source);
164 #endif
165 }
166 
167 static const struct dma_fence_ops drm_crtc_fence_ops;
168 
169 static struct drm_crtc *fence_to_crtc(struct dma_fence *fence)
170 {
171 	BUG_ON(fence->ops != &drm_crtc_fence_ops);
172 	return container_of(fence->lock, struct drm_crtc, fence_lock);
173 }
174 
175 static const char *drm_crtc_fence_get_driver_name(struct dma_fence *fence)
176 {
177 	struct drm_crtc *crtc = fence_to_crtc(fence);
178 
179 	return crtc->dev->driver->name;
180 }
181 
182 static const char *drm_crtc_fence_get_timeline_name(struct dma_fence *fence)
183 {
184 	struct drm_crtc *crtc = fence_to_crtc(fence);
185 
186 	return crtc->timeline_name;
187 }
188 
189 static const struct dma_fence_ops drm_crtc_fence_ops = {
190 	.get_driver_name = drm_crtc_fence_get_driver_name,
191 	.get_timeline_name = drm_crtc_fence_get_timeline_name,
192 };
193 
194 struct dma_fence *drm_crtc_create_fence(struct drm_crtc *crtc)
195 {
196 	struct dma_fence *fence;
197 
198 	fence = kzalloc(sizeof(*fence), GFP_KERNEL);
199 	if (!fence)
200 		return NULL;
201 
202 	dma_fence_init(fence, &drm_crtc_fence_ops, &crtc->fence_lock,
203 		       crtc->fence_context, ++crtc->fence_seqno);
204 
205 	return fence;
206 }
207 
208 /**
209  * DOC: standard CRTC properties
210  *
211  * DRM CRTCs have a few standardized properties:
212  *
213  * ACTIVE:
214  * 	Atomic property for setting the power state of the CRTC. When set to 1
215  * 	the CRTC will actively display content. When set to 0 the CRTC will be
216  * 	powered off. There is no expectation that user-space will reset CRTC
217  * 	resources like the mode and planes when setting ACTIVE to 0.
218  *
219  * 	User-space can rely on an ACTIVE change to 1 to never fail an atomic
220  * 	test as long as no other property has changed. If a change to ACTIVE
221  * 	fails an atomic test, this is a driver bug. For this reason setting
222  * 	ACTIVE to 0 must not release internal resources (like reserved memory
223  * 	bandwidth or clock generators).
224  *
225  * 	Note that the legacy DPMS property on connectors is internally routed
226  * 	to control this property for atomic drivers.
227  * MODE_ID:
228  * 	Atomic property for setting the CRTC display timings. The value is the
229  * 	ID of a blob containing the DRM mode info. To disable the CRTC,
230  * 	user-space must set this property to 0.
231  *
232  * 	Setting MODE_ID to 0 will release reserved resources for the CRTC.
233  * SCALING_FILTER:
234  * 	Atomic property for setting the scaling filter for CRTC scaler
235  *
236  * 	The value of this property can be one of the following:
237  *
238  * 	Default:
239  * 		Driver's default scaling filter
240  * 	Nearest Neighbor:
241  * 		Nearest Neighbor scaling filter
242  */
243 
244 __printf(6, 0)
245 static int __drm_crtc_init_with_planes(struct drm_device *dev, struct drm_crtc *crtc,
246 				       struct drm_plane *primary,
247 				       struct drm_plane *cursor,
248 				       const struct drm_crtc_funcs *funcs,
249 				       const char *name, va_list ap)
250 {
251 	struct drm_mode_config *config = &dev->mode_config;
252 	int ret;
253 
254 	WARN_ON(primary && primary->type != DRM_PLANE_TYPE_PRIMARY);
255 	WARN_ON(cursor && cursor->type != DRM_PLANE_TYPE_CURSOR);
256 
257 	/* crtc index is used with 32bit bitmasks */
258 	if (WARN_ON(config->num_crtc >= 32))
259 		return -EINVAL;
260 
261 	WARN_ON(drm_drv_uses_atomic_modeset(dev) &&
262 		(!funcs->atomic_destroy_state ||
263 		 !funcs->atomic_duplicate_state));
264 
265 	crtc->dev = dev;
266 	crtc->funcs = funcs;
267 
268 	INIT_LIST_HEAD(&crtc->commit_list);
269 	spin_lock_init(&crtc->commit_lock);
270 
271 	drm_modeset_lock_init(&crtc->mutex);
272 	ret = drm_mode_object_add(dev, &crtc->base, DRM_MODE_OBJECT_CRTC);
273 	if (ret)
274 		return ret;
275 
276 	if (name) {
277 		crtc->name = kvasprintf(GFP_KERNEL, name, ap);
278 	} else {
279 		crtc->name = kasprintf(GFP_KERNEL, "crtc-%d",
280 				       drm_num_crtcs(dev));
281 	}
282 	if (!crtc->name) {
283 		drm_mode_object_unregister(dev, &crtc->base);
284 		return -ENOMEM;
285 	}
286 
287 	crtc->fence_context = dma_fence_context_alloc(1);
288 	spin_lock_init(&crtc->fence_lock);
289 	snprintf(crtc->timeline_name, sizeof(crtc->timeline_name),
290 		 "CRTC:%d-%s", crtc->base.id, crtc->name);
291 
292 	crtc->base.properties = &crtc->properties;
293 
294 	list_add_tail(&crtc->head, &config->crtc_list);
295 	crtc->index = config->num_crtc++;
296 
297 	crtc->primary = primary;
298 	crtc->cursor = cursor;
299 	if (primary && !primary->possible_crtcs)
300 		primary->possible_crtcs = drm_crtc_mask(crtc);
301 	if (cursor && !cursor->possible_crtcs)
302 		cursor->possible_crtcs = drm_crtc_mask(crtc);
303 
304 	ret = drm_crtc_crc_init(crtc);
305 	if (ret) {
306 		drm_mode_object_unregister(dev, &crtc->base);
307 		return ret;
308 	}
309 
310 	if (drm_core_check_feature(dev, DRIVER_ATOMIC)) {
311 		drm_object_attach_property(&crtc->base, config->prop_active, 0);
312 		drm_object_attach_property(&crtc->base, config->prop_mode_id, 0);
313 		drm_object_attach_property(&crtc->base,
314 					   config->prop_out_fence_ptr, 0);
315 		drm_object_attach_property(&crtc->base,
316 					   config->prop_vrr_enabled, 0);
317 	}
318 
319 	return 0;
320 }
321 
322 /**
323  * drm_crtc_init_with_planes - Initialise a new CRTC object with
324  *    specified primary and cursor planes.
325  * @dev: DRM device
326  * @crtc: CRTC object to init
327  * @primary: Primary plane for CRTC
328  * @cursor: Cursor plane for CRTC
329  * @funcs: callbacks for the new CRTC
330  * @name: printf style format string for the CRTC name, or NULL for default name
331  *
332  * Inits a new object created as base part of a driver crtc object. Drivers
333  * should use this function instead of drm_crtc_init(), which is only provided
334  * for backwards compatibility with drivers which do not yet support universal
335  * planes). For really simple hardware which has only 1 plane look at
336  * drm_simple_display_pipe_init() instead.
337  * The &drm_crtc_funcs.destroy hook should call drm_crtc_cleanup() and kfree()
338  * the crtc structure. The crtc structure should not be allocated with
339  * devm_kzalloc().
340  *
341  * The @primary and @cursor planes are only relevant for legacy uAPI, see
342  * &drm_crtc.primary and &drm_crtc.cursor.
343  *
344  * Note: consider using drmm_crtc_alloc_with_planes() instead of
345  * drm_crtc_init_with_planes() to let the DRM managed resource infrastructure
346  * take care of cleanup and deallocation.
347  *
348  * Returns:
349  * Zero on success, error code on failure.
350  */
351 int drm_crtc_init_with_planes(struct drm_device *dev, struct drm_crtc *crtc,
352 			      struct drm_plane *primary,
353 			      struct drm_plane *cursor,
354 			      const struct drm_crtc_funcs *funcs,
355 			      const char *name, ...)
356 {
357 	va_list ap;
358 	int ret;
359 
360 	WARN_ON(!funcs->destroy);
361 
362 	va_start(ap, name);
363 	ret = __drm_crtc_init_with_planes(dev, crtc, primary, cursor, funcs,
364 					  name, ap);
365 	va_end(ap);
366 
367 	return ret;
368 }
369 EXPORT_SYMBOL(drm_crtc_init_with_planes);
370 
371 static void drmm_crtc_alloc_with_planes_cleanup(struct drm_device *dev,
372 						void *ptr)
373 {
374 	struct drm_crtc *crtc = ptr;
375 
376 	drm_crtc_cleanup(crtc);
377 }
378 
379 void *__drmm_crtc_alloc_with_planes(struct drm_device *dev,
380 				    size_t size, size_t offset,
381 				    struct drm_plane *primary,
382 				    struct drm_plane *cursor,
383 				    const struct drm_crtc_funcs *funcs,
384 				    const char *name, ...)
385 {
386 	void *container;
387 	struct drm_crtc *crtc;
388 	va_list ap;
389 	int ret;
390 
391 	if (WARN_ON(!funcs || funcs->destroy))
392 		return ERR_PTR(-EINVAL);
393 
394 	container = drmm_kzalloc(dev, size, GFP_KERNEL);
395 	if (!container)
396 		return ERR_PTR(-ENOMEM);
397 
398 	crtc = container + offset;
399 
400 	va_start(ap, name);
401 	ret = __drm_crtc_init_with_planes(dev, crtc, primary, cursor, funcs,
402 					  name, ap);
403 	va_end(ap);
404 	if (ret)
405 		return ERR_PTR(ret);
406 
407 	ret = drmm_add_action_or_reset(dev, drmm_crtc_alloc_with_planes_cleanup,
408 				       crtc);
409 	if (ret)
410 		return ERR_PTR(ret);
411 
412 	return container;
413 }
414 EXPORT_SYMBOL(__drmm_crtc_alloc_with_planes);
415 
416 /**
417  * drm_crtc_cleanup - Clean up the core crtc usage
418  * @crtc: CRTC to cleanup
419  *
420  * This function cleans up @crtc and removes it from the DRM mode setting
421  * core. Note that the function does *not* free the crtc structure itself,
422  * this is the responsibility of the caller.
423  */
424 void drm_crtc_cleanup(struct drm_crtc *crtc)
425 {
426 	struct drm_device *dev = crtc->dev;
427 
428 	/* Note that the crtc_list is considered to be static; should we
429 	 * remove the drm_crtc at runtime we would have to decrement all
430 	 * the indices on the drm_crtc after us in the crtc_list.
431 	 */
432 
433 	drm_crtc_crc_fini(crtc);
434 
435 	kfree(crtc->gamma_store);
436 	crtc->gamma_store = NULL;
437 
438 	drm_modeset_lock_fini(&crtc->mutex);
439 
440 	drm_mode_object_unregister(dev, &crtc->base);
441 	list_del(&crtc->head);
442 	dev->mode_config.num_crtc--;
443 
444 	WARN_ON(crtc->state && !crtc->funcs->atomic_destroy_state);
445 	if (crtc->state && crtc->funcs->atomic_destroy_state)
446 		crtc->funcs->atomic_destroy_state(crtc, crtc->state);
447 
448 	kfree(crtc->name);
449 
450 	memset(crtc, 0, sizeof(*crtc));
451 }
452 EXPORT_SYMBOL(drm_crtc_cleanup);
453 
454 /**
455  * drm_mode_getcrtc - get CRTC configuration
456  * @dev: drm device for the ioctl
457  * @data: data pointer for the ioctl
458  * @file_priv: drm file for the ioctl call
459  *
460  * Construct a CRTC configuration structure to return to the user.
461  *
462  * Called by the user via ioctl.
463  *
464  * Returns:
465  * Zero on success, negative errno on failure.
466  */
467 int drm_mode_getcrtc(struct drm_device *dev,
468 		     void *data, struct drm_file *file_priv)
469 {
470 	struct drm_mode_crtc *crtc_resp = data;
471 	struct drm_crtc *crtc;
472 	struct drm_plane *plane;
473 
474 	if (!drm_core_check_feature(dev, DRIVER_MODESET))
475 		return -EOPNOTSUPP;
476 
477 	crtc = drm_crtc_find(dev, file_priv, crtc_resp->crtc_id);
478 	if (!crtc)
479 		return -ENOENT;
480 
481 	plane = crtc->primary;
482 
483 	crtc_resp->gamma_size = crtc->gamma_size;
484 
485 	drm_modeset_lock(&plane->mutex, NULL);
486 	if (plane->state && plane->state->fb)
487 		crtc_resp->fb_id = plane->state->fb->base.id;
488 	else if (!plane->state && plane->fb)
489 		crtc_resp->fb_id = plane->fb->base.id;
490 	else
491 		crtc_resp->fb_id = 0;
492 
493 	if (plane->state) {
494 		crtc_resp->x = plane->state->src_x >> 16;
495 		crtc_resp->y = plane->state->src_y >> 16;
496 	}
497 	drm_modeset_unlock(&plane->mutex);
498 
499 	drm_modeset_lock(&crtc->mutex, NULL);
500 	if (crtc->state) {
501 		if (crtc->state->enable) {
502 			drm_mode_convert_to_umode(&crtc_resp->mode, &crtc->state->mode);
503 			crtc_resp->mode_valid = 1;
504 		} else {
505 			crtc_resp->mode_valid = 0;
506 		}
507 	} else {
508 		crtc_resp->x = crtc->x;
509 		crtc_resp->y = crtc->y;
510 
511 		if (crtc->enabled) {
512 			drm_mode_convert_to_umode(&crtc_resp->mode, &crtc->mode);
513 			crtc_resp->mode_valid = 1;
514 
515 		} else {
516 			crtc_resp->mode_valid = 0;
517 		}
518 	}
519 	if (!file_priv->aspect_ratio_allowed)
520 		crtc_resp->mode.flags &= ~DRM_MODE_FLAG_PIC_AR_MASK;
521 	drm_modeset_unlock(&crtc->mutex);
522 
523 	return 0;
524 }
525 
526 static int __drm_mode_set_config_internal(struct drm_mode_set *set,
527 					  struct drm_modeset_acquire_ctx *ctx)
528 {
529 	struct drm_crtc *crtc = set->crtc;
530 	struct drm_framebuffer *fb;
531 	struct drm_crtc *tmp;
532 	int ret;
533 
534 	WARN_ON(drm_drv_uses_atomic_modeset(crtc->dev));
535 
536 	/*
537 	 * NOTE: ->set_config can also disable other crtcs (if we steal all
538 	 * connectors from it), hence we need to refcount the fbs across all
539 	 * crtcs. Atomic modeset will have saner semantics ...
540 	 */
541 	drm_for_each_crtc(tmp, crtc->dev) {
542 		struct drm_plane *plane = tmp->primary;
543 
544 		plane->old_fb = plane->fb;
545 	}
546 
547 	fb = set->fb;
548 
549 	ret = crtc->funcs->set_config(set, ctx);
550 	if (ret == 0) {
551 		struct drm_plane *plane = crtc->primary;
552 
553 		plane->crtc = fb ? crtc : NULL;
554 		plane->fb = fb;
555 	}
556 
557 	drm_for_each_crtc(tmp, crtc->dev) {
558 		struct drm_plane *plane = tmp->primary;
559 
560 		if (plane->fb)
561 			drm_framebuffer_get(plane->fb);
562 		if (plane->old_fb)
563 			drm_framebuffer_put(plane->old_fb);
564 		plane->old_fb = NULL;
565 	}
566 
567 	return ret;
568 }
569 
570 /**
571  * drm_mode_set_config_internal - helper to call &drm_mode_config_funcs.set_config
572  * @set: modeset config to set
573  *
574  * This is a little helper to wrap internal calls to the
575  * &drm_mode_config_funcs.set_config driver interface. The only thing it adds is
576  * correct refcounting dance.
577  *
578  * This should only be used by non-atomic legacy drivers.
579  *
580  * Returns:
581  * Zero on success, negative errno on failure.
582  */
583 int drm_mode_set_config_internal(struct drm_mode_set *set)
584 {
585 	WARN_ON(drm_drv_uses_atomic_modeset(set->crtc->dev));
586 
587 	return __drm_mode_set_config_internal(set, NULL);
588 }
589 EXPORT_SYMBOL(drm_mode_set_config_internal);
590 
591 /**
592  * drm_crtc_check_viewport - Checks that a framebuffer is big enough for the
593  *     CRTC viewport
594  * @crtc: CRTC that framebuffer will be displayed on
595  * @x: x panning
596  * @y: y panning
597  * @mode: mode that framebuffer will be displayed under
598  * @fb: framebuffer to check size of
599  */
600 int drm_crtc_check_viewport(const struct drm_crtc *crtc,
601 			    int x, int y,
602 			    const struct drm_display_mode *mode,
603 			    const struct drm_framebuffer *fb)
604 
605 {
606 	int hdisplay, vdisplay;
607 
608 	drm_mode_get_hv_timing(mode, &hdisplay, &vdisplay);
609 
610 	if (crtc->state &&
611 	    drm_rotation_90_or_270(crtc->primary->state->rotation))
612 		swap(hdisplay, vdisplay);
613 
614 	return drm_framebuffer_check_src_coords(x << 16, y << 16,
615 						hdisplay << 16, vdisplay << 16,
616 						fb);
617 }
618 EXPORT_SYMBOL(drm_crtc_check_viewport);
619 
620 /**
621  * drm_mode_setcrtc - set CRTC configuration
622  * @dev: drm device for the ioctl
623  * @data: data pointer for the ioctl
624  * @file_priv: drm file for the ioctl call
625  *
626  * Build a new CRTC configuration based on user request.
627  *
628  * Called by the user via ioctl.
629  *
630  * Returns:
631  * Zero on success, negative errno on failure.
632  */
633 int drm_mode_setcrtc(struct drm_device *dev, void *data,
634 		     struct drm_file *file_priv)
635 {
636 	struct drm_mode_config *config = &dev->mode_config;
637 	struct drm_mode_crtc *crtc_req = data;
638 	struct drm_crtc *crtc;
639 	struct drm_plane *plane;
640 	struct drm_connector **connector_set = NULL, *connector;
641 	struct drm_framebuffer *fb = NULL;
642 	struct drm_display_mode *mode = NULL;
643 	struct drm_mode_set set;
644 	uint32_t __user *set_connectors_ptr;
645 	struct drm_modeset_acquire_ctx ctx;
646 	int ret;
647 	int i;
648 
649 	if (!drm_core_check_feature(dev, DRIVER_MODESET))
650 		return -EOPNOTSUPP;
651 
652 	/*
653 	 * Universal plane src offsets are only 16.16, prevent havoc for
654 	 * drivers using universal plane code internally.
655 	 */
656 	if (crtc_req->x & 0xffff0000 || crtc_req->y & 0xffff0000)
657 		return -ERANGE;
658 
659 	crtc = drm_crtc_find(dev, file_priv, crtc_req->crtc_id);
660 	if (!crtc) {
661 		DRM_DEBUG_KMS("Unknown CRTC ID %d\n", crtc_req->crtc_id);
662 		return -ENOENT;
663 	}
664 	DRM_DEBUG_KMS("[CRTC:%d:%s]\n", crtc->base.id, crtc->name);
665 
666 	plane = crtc->primary;
667 
668 	/* allow disabling with the primary plane leased */
669 	if (crtc_req->mode_valid && !drm_lease_held(file_priv, plane->base.id))
670 		return -EACCES;
671 
672 	DRM_MODESET_LOCK_ALL_BEGIN(dev, ctx,
673 				   DRM_MODESET_ACQUIRE_INTERRUPTIBLE, ret);
674 
675 	if (crtc_req->mode_valid) {
676 		/* If we have a mode we need a framebuffer. */
677 		/* If we pass -1, set the mode with the currently bound fb */
678 		if (crtc_req->fb_id == -1) {
679 			struct drm_framebuffer *old_fb;
680 
681 			if (plane->state)
682 				old_fb = plane->state->fb;
683 			else
684 				old_fb = plane->fb;
685 
686 			if (!old_fb) {
687 				DRM_DEBUG_KMS("CRTC doesn't have current FB\n");
688 				ret = -EINVAL;
689 				goto out;
690 			}
691 
692 			fb = old_fb;
693 			/* Make refcounting symmetric with the lookup path. */
694 			drm_framebuffer_get(fb);
695 		} else {
696 			fb = drm_framebuffer_lookup(dev, file_priv, crtc_req->fb_id);
697 			if (!fb) {
698 				DRM_DEBUG_KMS("Unknown FB ID%d\n",
699 						crtc_req->fb_id);
700 				ret = -ENOENT;
701 				goto out;
702 			}
703 		}
704 
705 		mode = drm_mode_create(dev);
706 		if (!mode) {
707 			ret = -ENOMEM;
708 			goto out;
709 		}
710 		if (!file_priv->aspect_ratio_allowed &&
711 		    (crtc_req->mode.flags & DRM_MODE_FLAG_PIC_AR_MASK) != DRM_MODE_FLAG_PIC_AR_NONE) {
712 			DRM_DEBUG_KMS("Unexpected aspect-ratio flag bits\n");
713 			ret = -EINVAL;
714 			goto out;
715 		}
716 
717 
718 		ret = drm_mode_convert_umode(dev, mode, &crtc_req->mode);
719 		if (ret) {
720 			DRM_DEBUG_KMS("Invalid mode (ret=%d, status=%s)\n",
721 				      ret, drm_get_mode_status_name(mode->status));
722 			drm_mode_debug_printmodeline(mode);
723 			goto out;
724 		}
725 
726 		/*
727 		 * Check whether the primary plane supports the fb pixel format.
728 		 * Drivers not implementing the universal planes API use a
729 		 * default formats list provided by the DRM core which doesn't
730 		 * match real hardware capabilities. Skip the check in that
731 		 * case.
732 		 */
733 		if (!plane->format_default) {
734 			ret = drm_plane_check_pixel_format(plane,
735 							   fb->format->format,
736 							   fb->modifier);
737 			if (ret) {
738 				struct drm_format_name_buf format_name;
739 
740 				DRM_DEBUG_KMS("Invalid pixel format %s, modifier 0x%llx\n",
741 					      drm_get_format_name(fb->format->format,
742 								  &format_name),
743 					      fb->modifier);
744 				goto out;
745 			}
746 		}
747 
748 		ret = drm_crtc_check_viewport(crtc, crtc_req->x, crtc_req->y,
749 					      mode, fb);
750 		if (ret)
751 			goto out;
752 
753 	}
754 
755 	if (crtc_req->count_connectors == 0 && mode) {
756 		DRM_DEBUG_KMS("Count connectors is 0 but mode set\n");
757 		ret = -EINVAL;
758 		goto out;
759 	}
760 
761 	if (crtc_req->count_connectors > 0 && (!mode || !fb)) {
762 		DRM_DEBUG_KMS("Count connectors is %d but no mode or fb set\n",
763 			  crtc_req->count_connectors);
764 		ret = -EINVAL;
765 		goto out;
766 	}
767 
768 	if (crtc_req->count_connectors > 0) {
769 		u32 out_id;
770 
771 		/* Avoid unbounded kernel memory allocation */
772 		if (crtc_req->count_connectors > config->num_connector) {
773 			ret = -EINVAL;
774 			goto out;
775 		}
776 
777 		connector_set = kmalloc_array(crtc_req->count_connectors,
778 					      sizeof(struct drm_connector *),
779 					      GFP_KERNEL);
780 		if (!connector_set) {
781 			ret = -ENOMEM;
782 			goto out;
783 		}
784 
785 		for (i = 0; i < crtc_req->count_connectors; i++) {
786 			connector_set[i] = NULL;
787 			set_connectors_ptr = (uint32_t __user *)(unsigned long)crtc_req->set_connectors_ptr;
788 			if (get_user(out_id, &set_connectors_ptr[i])) {
789 				ret = -EFAULT;
790 				goto out;
791 			}
792 
793 			connector = drm_connector_lookup(dev, file_priv, out_id);
794 			if (!connector) {
795 				DRM_DEBUG_KMS("Connector id %d unknown\n",
796 						out_id);
797 				ret = -ENOENT;
798 				goto out;
799 			}
800 			DRM_DEBUG_KMS("[CONNECTOR:%d:%s]\n",
801 					connector->base.id,
802 					connector->name);
803 
804 			connector_set[i] = connector;
805 		}
806 	}
807 
808 	set.crtc = crtc;
809 	set.x = crtc_req->x;
810 	set.y = crtc_req->y;
811 	set.mode = mode;
812 	set.connectors = connector_set;
813 	set.num_connectors = crtc_req->count_connectors;
814 	set.fb = fb;
815 
816 	if (drm_drv_uses_atomic_modeset(dev))
817 		ret = crtc->funcs->set_config(&set, &ctx);
818 	else
819 		ret = __drm_mode_set_config_internal(&set, &ctx);
820 
821 out:
822 	if (fb)
823 		drm_framebuffer_put(fb);
824 
825 	if (connector_set) {
826 		for (i = 0; i < crtc_req->count_connectors; i++) {
827 			if (connector_set[i])
828 				drm_connector_put(connector_set[i]);
829 		}
830 	}
831 	kfree(connector_set);
832 	drm_mode_destroy(dev, mode);
833 
834 	/* In case we need to retry... */
835 	connector_set = NULL;
836 	fb = NULL;
837 	mode = NULL;
838 
839 	DRM_MODESET_LOCK_ALL_END(dev, ctx, ret);
840 
841 	return ret;
842 }
843 
844 int drm_mode_crtc_set_obj_prop(struct drm_mode_object *obj,
845 			       struct drm_property *property,
846 			       uint64_t value)
847 {
848 	int ret = -EINVAL;
849 	struct drm_crtc *crtc = obj_to_crtc(obj);
850 
851 	if (crtc->funcs->set_property)
852 		ret = crtc->funcs->set_property(crtc, property, value);
853 	if (!ret)
854 		drm_object_property_set_value(obj, property, value);
855 
856 	return ret;
857 }
858 
859 /**
860  * drm_crtc_create_scaling_filter_property - create a new scaling filter
861  * property
862  *
863  * @crtc: drm CRTC
864  * @supported_filters: bitmask of supported scaling filters, must include
865  *		       BIT(DRM_SCALING_FILTER_DEFAULT).
866  *
867  * This function lets driver to enable the scaling filter property on a given
868  * CRTC.
869  *
870  * RETURNS:
871  * Zero for success or -errno
872  */
873 int drm_crtc_create_scaling_filter_property(struct drm_crtc *crtc,
874 					    unsigned int supported_filters)
875 {
876 	struct drm_property *prop =
877 		drm_create_scaling_filter_prop(crtc->dev, supported_filters);
878 
879 	if (IS_ERR(prop))
880 		return PTR_ERR(prop);
881 
882 	drm_object_attach_property(&crtc->base, prop,
883 				   DRM_SCALING_FILTER_DEFAULT);
884 	crtc->scaling_filter_property = prop;
885 
886 	return 0;
887 }
888 EXPORT_SYMBOL(drm_crtc_create_scaling_filter_property);
889