2 * Copyright (c) 2006-2008 Intel Corporation
3 * Copyright (c) 2007 Dave Airlie <airlied@linux.ie>
4 * Copyright (c) 2008 Red Hat Inc.
6 * DRM core CRTC related functions
8 * Permission to use, copy, modify, distribute, and sell this software and its
9 * documentation for any purpose is hereby granted without fee, provided that
10 * the above copyright notice appear in all copies and that both that copyright
11 * notice and this permission notice appear in supporting documentation, and
12 * that the name of the copyright holders not be used in advertising or
13 * publicity pertaining to distribution of the software without specific,
14 * written prior permission. The copyright holders make no representations
15 * about the suitability of this software for any purpose. It is provided "as
16 * is" without express or implied warranty.
18 * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
19 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
20 * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
21 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
22 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
23 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
28 * Eric Anholt <eric@anholt.net>
29 * Dave Airlie <airlied@linux.ie>
30 * Jesse Barnes <jesse.barnes@intel.com>
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>
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>
46 #include "drm_crtc_internal.h"
47 #include "drm_internal.h"
50 * drm_crtc_from_index - find the registered CRTC at an index
52 * @idx: index of registered CRTC to find for
54 * Given a CRTC index, return the registered CRTC from DRM device's
55 * list of CRTCs with matching index. This is the inverse of drm_crtc_index().
56 * It's useful in the vblank callbacks (like &drm_driver.enable_vblank or
57 * &drm_driver.disable_vblank), since that still deals with indices instead
58 * of pointers to &struct drm_crtc."
60 struct drm_crtc
*drm_crtc_from_index(struct drm_device
*dev
, int idx
)
62 struct drm_crtc
*crtc
;
64 drm_for_each_crtc(crtc
, dev
)
65 if (idx
== crtc
->index
)
70 EXPORT_SYMBOL(drm_crtc_from_index
);
73 * drm_crtc_force_disable - Forcibly turn off a CRTC
74 * @crtc: CRTC to turn off
77 * Zero on success, error code on failure.
79 int drm_crtc_force_disable(struct drm_crtc
*crtc
)
81 struct drm_mode_set set
= {
85 return drm_mode_set_config_internal(&set
);
87 EXPORT_SYMBOL(drm_crtc_force_disable
);
90 * drm_crtc_force_disable_all - Forcibly turn off all enabled CRTCs
91 * @dev: DRM device whose CRTCs to turn off
93 * Drivers may want to call this on unload to ensure that all displays are
94 * unlit and the GPU is in a consistent, low power state. Takes modeset locks.
97 * Zero on success, error code on failure.
99 int drm_crtc_force_disable_all(struct drm_device
*dev
)
101 struct drm_crtc
*crtc
;
104 drm_modeset_lock_all(dev
);
105 drm_for_each_crtc(crtc
, dev
)
107 ret
= drm_crtc_force_disable(crtc
);
112 drm_modeset_unlock_all(dev
);
115 EXPORT_SYMBOL(drm_crtc_force_disable_all
);
117 static unsigned int drm_num_crtcs(struct drm_device
*dev
)
119 unsigned int num
= 0;
120 struct drm_crtc
*tmp
;
122 drm_for_each_crtc(tmp
, dev
) {
129 int drm_crtc_register_all(struct drm_device
*dev
)
131 struct drm_crtc
*crtc
;
134 drm_for_each_crtc(crtc
, dev
) {
135 if (drm_debugfs_crtc_add(crtc
))
136 DRM_ERROR("Failed to initialize debugfs entry for CRTC '%s'.\n",
139 if (crtc
->funcs
->late_register
)
140 ret
= crtc
->funcs
->late_register(crtc
);
148 void drm_crtc_unregister_all(struct drm_device
*dev
)
150 struct drm_crtc
*crtc
;
152 drm_for_each_crtc(crtc
, dev
) {
153 if (crtc
->funcs
->early_unregister
)
154 crtc
->funcs
->early_unregister(crtc
);
155 drm_debugfs_crtc_remove(crtc
);
159 static int drm_crtc_crc_init(struct drm_crtc
*crtc
)
161 #ifdef CONFIG_DEBUG_FS
162 spin_lock_init(&crtc
->crc
.lock
);
163 init_waitqueue_head(&crtc
->crc
.wq
);
164 crtc
->crc
.source
= kstrdup("auto", GFP_KERNEL
);
165 if (!crtc
->crc
.source
)
171 static void drm_crtc_crc_fini(struct drm_crtc
*crtc
)
173 #ifdef CONFIG_DEBUG_FS
174 kfree(crtc
->crc
.source
);
178 static const struct dma_fence_ops drm_crtc_fence_ops
;
180 static struct drm_crtc
*fence_to_crtc(struct dma_fence
*fence
)
182 BUG_ON(fence
->ops
!= &drm_crtc_fence_ops
);
183 return container_of(fence
->lock
, struct drm_crtc
, fence_lock
);
186 static const char *drm_crtc_fence_get_driver_name(struct dma_fence
*fence
)
188 struct drm_crtc
*crtc
= fence_to_crtc(fence
);
190 return crtc
->dev
->driver
->name
;
193 static const char *drm_crtc_fence_get_timeline_name(struct dma_fence
*fence
)
195 struct drm_crtc
*crtc
= fence_to_crtc(fence
);
197 return crtc
->timeline_name
;
200 static bool drm_crtc_fence_enable_signaling(struct dma_fence
*fence
)
205 static const struct dma_fence_ops drm_crtc_fence_ops
= {
206 .get_driver_name
= drm_crtc_fence_get_driver_name
,
207 .get_timeline_name
= drm_crtc_fence_get_timeline_name
,
208 .enable_signaling
= drm_crtc_fence_enable_signaling
,
209 .wait
= dma_fence_default_wait
,
212 struct dma_fence
*drm_crtc_create_fence(struct drm_crtc
*crtc
)
214 struct dma_fence
*fence
;
216 fence
= kzalloc(sizeof(*fence
), GFP_KERNEL
);
220 dma_fence_init(fence
, &drm_crtc_fence_ops
, &crtc
->fence_lock
,
221 crtc
->fence_context
, ++crtc
->fence_seqno
);
227 * drm_crtc_init_with_planes - Initialise a new CRTC object with
228 * specified primary and cursor planes.
230 * @crtc: CRTC object to init
231 * @primary: Primary plane for CRTC
232 * @cursor: Cursor plane for CRTC
233 * @funcs: callbacks for the new CRTC
234 * @name: printf style format string for the CRTC name, or NULL for default name
236 * Inits a new object created as base part of a driver crtc object. Drivers
237 * should use this function instead of drm_crtc_init(), which is only provided
238 * for backwards compatibility with drivers which do not yet support universal
239 * planes). For really simple hardware which has only 1 plane look at
240 * drm_simple_display_pipe_init() instead.
243 * Zero on success, error code on failure.
245 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
, ...)
251 struct drm_mode_config
*config
= &dev
->mode_config
;
254 WARN_ON(primary
&& primary
->type
!= DRM_PLANE_TYPE_PRIMARY
);
255 WARN_ON(cursor
&& cursor
->type
!= DRM_PLANE_TYPE_CURSOR
);
260 INIT_LIST_HEAD(&crtc
->commit_list
);
261 spin_lock_init(&crtc
->commit_lock
);
263 drm_modeset_lock_init(&crtc
->mutex
);
264 ret
= drm_mode_object_get(dev
, &crtc
->base
, DRM_MODE_OBJECT_CRTC
);
272 crtc
->name
= kvasprintf(GFP_KERNEL
, name
, ap
);
275 crtc
->name
= kasprintf(GFP_KERNEL
, "crtc-%d",
279 drm_mode_object_unregister(dev
, &crtc
->base
);
283 crtc
->fence_context
= dma_fence_context_alloc(1);
284 spin_lock_init(&crtc
->fence_lock
);
285 snprintf(crtc
->timeline_name
, sizeof(crtc
->timeline_name
),
286 "CRTC:%d-%s", crtc
->base
.id
, crtc
->name
);
288 crtc
->base
.properties
= &crtc
->properties
;
290 list_add_tail(&crtc
->head
, &config
->crtc_list
);
291 crtc
->index
= config
->num_crtc
++;
293 crtc
->primary
= primary
;
294 crtc
->cursor
= cursor
;
295 if (primary
&& !primary
->possible_crtcs
)
296 primary
->possible_crtcs
= 1 << drm_crtc_index(crtc
);
297 if (cursor
&& !cursor
->possible_crtcs
)
298 cursor
->possible_crtcs
= 1 << drm_crtc_index(crtc
);
300 ret
= drm_crtc_crc_init(crtc
);
302 drm_mode_object_unregister(dev
, &crtc
->base
);
306 if (drm_core_check_feature(dev
, DRIVER_ATOMIC
)) {
307 drm_object_attach_property(&crtc
->base
, config
->prop_active
, 0);
308 drm_object_attach_property(&crtc
->base
, config
->prop_mode_id
, 0);
309 drm_object_attach_property(&crtc
->base
,
310 config
->prop_out_fence_ptr
, 0);
315 EXPORT_SYMBOL(drm_crtc_init_with_planes
);
318 * drm_crtc_cleanup - Clean up the core crtc usage
319 * @crtc: CRTC to cleanup
321 * This function cleans up @crtc and removes it from the DRM mode setting
322 * core. Note that the function does *not* free the crtc structure itself,
323 * this is the responsibility of the caller.
325 void drm_crtc_cleanup(struct drm_crtc
*crtc
)
327 struct drm_device
*dev
= crtc
->dev
;
329 /* Note that the crtc_list is considered to be static; should we
330 * remove the drm_crtc at runtime we would have to decrement all
331 * the indices on the drm_crtc after us in the crtc_list.
334 drm_crtc_crc_fini(crtc
);
336 kfree(crtc
->gamma_store
);
337 crtc
->gamma_store
= NULL
;
339 drm_modeset_lock_fini(&crtc
->mutex
);
341 drm_mode_object_unregister(dev
, &crtc
->base
);
342 list_del(&crtc
->head
);
343 dev
->mode_config
.num_crtc
--;
345 WARN_ON(crtc
->state
&& !crtc
->funcs
->atomic_destroy_state
);
346 if (crtc
->state
&& crtc
->funcs
->atomic_destroy_state
)
347 crtc
->funcs
->atomic_destroy_state(crtc
, crtc
->state
);
351 memset(crtc
, 0, sizeof(*crtc
));
353 EXPORT_SYMBOL(drm_crtc_cleanup
);
356 * drm_mode_getcrtc - get CRTC configuration
357 * @dev: drm device for the ioctl
358 * @data: data pointer for the ioctl
359 * @file_priv: drm file for the ioctl call
361 * Construct a CRTC configuration structure to return to the user.
363 * Called by the user via ioctl.
366 * Zero on success, negative errno on failure.
368 int drm_mode_getcrtc(struct drm_device
*dev
,
369 void *data
, struct drm_file
*file_priv
)
371 struct drm_mode_crtc
*crtc_resp
= data
;
372 struct drm_crtc
*crtc
;
374 if (!drm_core_check_feature(dev
, DRIVER_MODESET
))
377 crtc
= drm_crtc_find(dev
, crtc_resp
->crtc_id
);
381 drm_modeset_lock_crtc(crtc
, crtc
->primary
);
382 crtc_resp
->gamma_size
= crtc
->gamma_size
;
384 if (crtc
->primary
->state
&& crtc
->primary
->state
->fb
)
385 crtc_resp
->fb_id
= crtc
->primary
->state
->fb
->base
.id
;
386 else if (!crtc
->primary
->state
&& crtc
->primary
->fb
)
387 crtc_resp
->fb_id
= crtc
->primary
->fb
->base
.id
;
389 crtc_resp
->fb_id
= 0;
392 crtc_resp
->x
= crtc
->primary
->state
->src_x
>> 16;
393 crtc_resp
->y
= crtc
->primary
->state
->src_y
>> 16;
394 if (crtc
->state
->enable
) {
395 drm_mode_convert_to_umode(&crtc_resp
->mode
, &crtc
->state
->mode
);
396 crtc_resp
->mode_valid
= 1;
399 crtc_resp
->mode_valid
= 0;
402 crtc_resp
->x
= crtc
->x
;
403 crtc_resp
->y
= crtc
->y
;
405 drm_mode_convert_to_umode(&crtc_resp
->mode
, &crtc
->mode
);
406 crtc_resp
->mode_valid
= 1;
409 crtc_resp
->mode_valid
= 0;
412 drm_modeset_unlock_crtc(crtc
);
418 * drm_mode_set_config_internal - helper to call ->set_config
419 * @set: modeset config to set
421 * This is a little helper to wrap internal calls to the ->set_config driver
422 * interface. The only thing it adds is correct refcounting dance.
425 * Zero on success, negative errno on failure.
427 int drm_mode_set_config_internal(struct drm_mode_set
*set
)
429 struct drm_crtc
*crtc
= set
->crtc
;
430 struct drm_framebuffer
*fb
;
431 struct drm_crtc
*tmp
;
435 * NOTE: ->set_config can also disable other crtcs (if we steal all
436 * connectors from it), hence we need to refcount the fbs across all
437 * crtcs. Atomic modeset will have saner semantics ...
439 drm_for_each_crtc(tmp
, crtc
->dev
)
440 tmp
->primary
->old_fb
= tmp
->primary
->fb
;
444 ret
= crtc
->funcs
->set_config(set
);
446 crtc
->primary
->crtc
= crtc
;
447 crtc
->primary
->fb
= fb
;
450 drm_for_each_crtc(tmp
, crtc
->dev
) {
451 if (tmp
->primary
->fb
)
452 drm_framebuffer_reference(tmp
->primary
->fb
);
453 if (tmp
->primary
->old_fb
)
454 drm_framebuffer_unreference(tmp
->primary
->old_fb
);
455 tmp
->primary
->old_fb
= NULL
;
460 EXPORT_SYMBOL(drm_mode_set_config_internal
);
463 * drm_crtc_get_hv_timing - Fetches hdisplay/vdisplay for given mode
464 * @mode: mode to query
465 * @hdisplay: hdisplay value to fill in
466 * @vdisplay: vdisplay value to fill in
468 * The vdisplay value will be doubled if the specified mode is a stereo mode of
469 * the appropriate layout.
471 void drm_crtc_get_hv_timing(const struct drm_display_mode
*mode
,
472 int *hdisplay
, int *vdisplay
)
474 struct drm_display_mode adjusted
;
476 drm_mode_copy(&adjusted
, mode
);
477 drm_mode_set_crtcinfo(&adjusted
, CRTC_STEREO_DOUBLE_ONLY
);
478 *hdisplay
= adjusted
.crtc_hdisplay
;
479 *vdisplay
= adjusted
.crtc_vdisplay
;
481 EXPORT_SYMBOL(drm_crtc_get_hv_timing
);
484 * drm_crtc_check_viewport - Checks that a framebuffer is big enough for the
486 * @crtc: CRTC that framebuffer will be displayed on
489 * @mode: mode that framebuffer will be displayed under
490 * @fb: framebuffer to check size of
492 int drm_crtc_check_viewport(const struct drm_crtc
*crtc
,
494 const struct drm_display_mode
*mode
,
495 const struct drm_framebuffer
*fb
)
498 int hdisplay
, vdisplay
;
500 drm_crtc_get_hv_timing(mode
, &hdisplay
, &vdisplay
);
503 drm_rotation_90_or_270(crtc
->primary
->state
->rotation
))
504 swap(hdisplay
, vdisplay
);
506 return drm_framebuffer_check_src_coords(x
<< 16, y
<< 16,
507 hdisplay
<< 16, vdisplay
<< 16,
510 EXPORT_SYMBOL(drm_crtc_check_viewport
);
513 * drm_mode_setcrtc - set CRTC configuration
514 * @dev: drm device for the ioctl
515 * @data: data pointer for the ioctl
516 * @file_priv: drm file for the ioctl call
518 * Build a new CRTC configuration based on user request.
520 * Called by the user via ioctl.
523 * Zero on success, negative errno on failure.
525 int drm_mode_setcrtc(struct drm_device
*dev
, void *data
,
526 struct drm_file
*file_priv
)
528 struct drm_mode_config
*config
= &dev
->mode_config
;
529 struct drm_mode_crtc
*crtc_req
= data
;
530 struct drm_crtc
*crtc
;
531 struct drm_connector
**connector_set
= NULL
, *connector
;
532 struct drm_framebuffer
*fb
= NULL
;
533 struct drm_display_mode
*mode
= NULL
;
534 struct drm_mode_set set
;
535 uint32_t __user
*set_connectors_ptr
;
539 if (!drm_core_check_feature(dev
, DRIVER_MODESET
))
543 * Universal plane src offsets are only 16.16, prevent havoc for
544 * drivers using universal plane code internally.
546 if (crtc_req
->x
& 0xffff0000 || crtc_req
->y
& 0xffff0000)
549 drm_modeset_lock_all(dev
);
550 crtc
= drm_crtc_find(dev
, crtc_req
->crtc_id
);
552 DRM_DEBUG_KMS("Unknown CRTC ID %d\n", crtc_req
->crtc_id
);
556 DRM_DEBUG_KMS("[CRTC:%d:%s]\n", crtc
->base
.id
, crtc
->name
);
558 if (crtc_req
->mode_valid
) {
559 /* If we have a mode we need a framebuffer. */
560 /* If we pass -1, set the mode with the currently bound fb */
561 if (crtc_req
->fb_id
== -1) {
562 if (!crtc
->primary
->fb
) {
563 DRM_DEBUG_KMS("CRTC doesn't have current FB\n");
567 fb
= crtc
->primary
->fb
;
568 /* Make refcounting symmetric with the lookup path. */
569 drm_framebuffer_reference(fb
);
571 fb
= drm_framebuffer_lookup(dev
, crtc_req
->fb_id
);
573 DRM_DEBUG_KMS("Unknown FB ID%d\n",
580 mode
= drm_mode_create(dev
);
586 ret
= drm_mode_convert_umode(mode
, &crtc_req
->mode
);
588 DRM_DEBUG_KMS("Invalid mode\n");
593 * Check whether the primary plane supports the fb pixel format.
594 * Drivers not implementing the universal planes API use a
595 * default formats list provided by the DRM core which doesn't
596 * match real hardware capabilities. Skip the check in that
599 if (!crtc
->primary
->format_default
) {
600 ret
= drm_plane_check_pixel_format(crtc
->primary
,
603 struct drm_format_name_buf format_name
;
604 DRM_DEBUG_KMS("Invalid pixel format %s\n",
605 drm_get_format_name(fb
->format
->format
,
611 ret
= drm_crtc_check_viewport(crtc
, crtc_req
->x
, crtc_req
->y
,
618 if (crtc_req
->count_connectors
== 0 && mode
) {
619 DRM_DEBUG_KMS("Count connectors is 0 but mode set\n");
624 if (crtc_req
->count_connectors
> 0 && (!mode
|| !fb
)) {
625 DRM_DEBUG_KMS("Count connectors is %d but no mode or fb set\n",
626 crtc_req
->count_connectors
);
631 if (crtc_req
->count_connectors
> 0) {
634 /* Avoid unbounded kernel memory allocation */
635 if (crtc_req
->count_connectors
> config
->num_connector
) {
640 connector_set
= kmalloc_array(crtc_req
->count_connectors
,
641 sizeof(struct drm_connector
*),
643 if (!connector_set
) {
648 for (i
= 0; i
< crtc_req
->count_connectors
; i
++) {
649 connector_set
[i
] = NULL
;
650 set_connectors_ptr
= (uint32_t __user
*)(unsigned long)crtc_req
->set_connectors_ptr
;
651 if (get_user(out_id
, &set_connectors_ptr
[i
])) {
656 connector
= drm_connector_lookup(dev
, out_id
);
658 DRM_DEBUG_KMS("Connector id %d unknown\n",
663 DRM_DEBUG_KMS("[CONNECTOR:%d:%s]\n",
667 connector_set
[i
] = connector
;
675 set
.connectors
= connector_set
;
676 set
.num_connectors
= crtc_req
->count_connectors
;
678 ret
= drm_mode_set_config_internal(&set
);
682 drm_framebuffer_unreference(fb
);
685 for (i
= 0; i
< crtc_req
->count_connectors
; i
++) {
686 if (connector_set
[i
])
687 drm_connector_unreference(connector_set
[i
]);
690 kfree(connector_set
);
691 drm_mode_destroy(dev
, mode
);
692 drm_modeset_unlock_all(dev
);
696 int drm_mode_crtc_set_obj_prop(struct drm_mode_object
*obj
,
697 struct drm_property
*property
,
701 struct drm_crtc
*crtc
= obj_to_crtc(obj
);
703 if (crtc
->funcs
->set_property
)
704 ret
= crtc
->funcs
->set_property(crtc
, property
, value
);
706 drm_object_property_set_value(obj
, property
, value
);