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