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