drm: Extract drm_plane.[hc]
Just pure code movement, cleanup and polish will happen in later
patches.
v2: Don't forget all the ioctl! To extract those cleanly I decided to
put check_src_coords into drm_framebuffer.c (and give it a
drm_framebuffer_ prefix), since that just checks framebuffer
constraints.
v3: rebase over PAGE_FLIP_TARGET.
Reviewed-by: Sean Paul <seanpaul@chromium.org>
Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>
[seanpaul]
This patch as posted on the list was rebased on:
commit 6f00975c619064a18c23fd3aced325ae165a73b9
Author: Daniel Vetter <daniel.vetter@ffwll.ch>
Date: Sat Aug 20 12:22:11 2016 +0200
drm: Reject page_flip for !DRIVER_MODESET
so as a result of moving the page_flip ioctl, this fix has
been rolled into this patch.
Signed-off-by: Sean Paul <seanpaul@chromium.org>
This commit is contained in:
Daniel Vetter
Sean Paul
parent
ce2f2c3f82
commit
43968d7b80
@ -110,6 +110,18 @@ Note that dumb objects may not be used for gpu acceleration, as has been
|
|||||||
attempted on some ARM embedded platforms. Such drivers really must have
|
attempted on some ARM embedded platforms. Such drivers really must have
|
||||||
a hardware-specific ioctl to allocate suitable buffer objects.
|
a hardware-specific ioctl to allocate suitable buffer objects.
|
||||||
|
|
||||||
|
Plane Abstraction
|
||||||
|
=================
|
||||||
|
|
||||||
|
Plane Functions Reference
|
||||||
|
-------------------------
|
||||||
|
|
||||||
|
.. kernel-doc:: include/drm/drm_plane.h
|
||||||
|
:internal:
|
||||||
|
|
||||||
|
.. kernel-doc:: drivers/gpu/drm/drm_plane.c
|
||||||
|
:export:
|
||||||
|
|
||||||
Display Modes Function Reference
|
Display Modes Function Reference
|
||||||
================================
|
================================
|
||||||
|
|
||||||
|
|||||||
@ -14,7 +14,8 @@ drm-y := drm_auth.o drm_bufs.o drm_cache.o \
|
|||||||
drm_rect.o drm_vma_manager.o drm_flip_work.o \
|
drm_rect.o drm_vma_manager.o drm_flip_work.o \
|
||||||
drm_modeset_lock.o drm_atomic.o drm_bridge.o \
|
drm_modeset_lock.o drm_atomic.o drm_bridge.o \
|
||||||
drm_framebuffer.o drm_connector.o drm_blend.o \
|
drm_framebuffer.o drm_connector.o drm_blend.o \
|
||||||
drm_encoder.o drm_mode_object.o drm_property.o
|
drm_encoder.o drm_mode_object.o drm_property.o \
|
||||||
|
drm_plane.o
|
||||||
|
|
||||||
drm-$(CONFIG_COMPAT) += drm_ioc32.o
|
drm-$(CONFIG_COMPAT) += drm_ioc32.o
|
||||||
drm-$(CONFIG_DRM_GEM_CMA_HELPER) += drm_gem_cma_helper.o
|
drm-$(CONFIG_DRM_GEM_CMA_HELPER) += drm_gem_cma_helper.o
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@ -36,8 +36,6 @@
|
|||||||
int drm_mode_crtc_set_obj_prop(struct drm_mode_object *obj,
|
int drm_mode_crtc_set_obj_prop(struct drm_mode_object *obj,
|
||||||
struct drm_property *property,
|
struct drm_property *property,
|
||||||
uint64_t value);
|
uint64_t value);
|
||||||
int drm_plane_check_pixel_format(const struct drm_plane *plane,
|
|
||||||
u32 format);
|
|
||||||
int drm_crtc_check_viewport(const struct drm_crtc *crtc,
|
int drm_crtc_check_viewport(const struct drm_crtc *crtc,
|
||||||
int x, int y,
|
int x, int y,
|
||||||
const struct drm_display_mode *mode,
|
const struct drm_display_mode *mode,
|
||||||
@ -56,28 +54,15 @@ int drm_mode_destroy_dumb_ioctl(struct drm_device *dev,
|
|||||||
/* IOCTLs */
|
/* IOCTLs */
|
||||||
int drm_mode_getresources(struct drm_device *dev,
|
int drm_mode_getresources(struct drm_device *dev,
|
||||||
void *data, struct drm_file *file_priv);
|
void *data, struct drm_file *file_priv);
|
||||||
int drm_mode_getplane_res(struct drm_device *dev, void *data,
|
|
||||||
struct drm_file *file_priv);
|
|
||||||
int drm_mode_getcrtc(struct drm_device *dev,
|
int drm_mode_getcrtc(struct drm_device *dev,
|
||||||
void *data, struct drm_file *file_priv);
|
void *data, struct drm_file *file_priv);
|
||||||
int drm_mode_setcrtc(struct drm_device *dev,
|
int drm_mode_setcrtc(struct drm_device *dev,
|
||||||
void *data, struct drm_file *file_priv);
|
void *data, struct drm_file *file_priv);
|
||||||
int drm_mode_getplane(struct drm_device *dev,
|
|
||||||
void *data, struct drm_file *file_priv);
|
|
||||||
int drm_mode_setplane(struct drm_device *dev,
|
|
||||||
void *data, struct drm_file *file_priv);
|
|
||||||
int drm_mode_cursor_ioctl(struct drm_device *dev,
|
|
||||||
void *data, struct drm_file *file_priv);
|
|
||||||
int drm_mode_cursor2_ioctl(struct drm_device *dev,
|
|
||||||
void *data, struct drm_file *file_priv);
|
|
||||||
int drm_mode_gamma_get_ioctl(struct drm_device *dev,
|
int drm_mode_gamma_get_ioctl(struct drm_device *dev,
|
||||||
void *data, struct drm_file *file_priv);
|
void *data, struct drm_file *file_priv);
|
||||||
int drm_mode_gamma_set_ioctl(struct drm_device *dev,
|
int drm_mode_gamma_set_ioctl(struct drm_device *dev,
|
||||||
void *data, struct drm_file *file_priv);
|
void *data, struct drm_file *file_priv);
|
||||||
|
|
||||||
int drm_mode_page_flip_ioctl(struct drm_device *dev,
|
|
||||||
void *data, struct drm_file *file_priv);
|
|
||||||
|
|
||||||
/* drm_property.c */
|
/* drm_property.c */
|
||||||
void drm_property_destroy_user_blobs(struct drm_device *dev,
|
void drm_property_destroy_user_blobs(struct drm_device *dev,
|
||||||
struct drm_file *file_priv);
|
struct drm_file *file_priv);
|
||||||
@ -155,6 +140,9 @@ drm_internal_framebuffer_create(struct drm_device *dev,
|
|||||||
const struct drm_mode_fb_cmd2 *r,
|
const struct drm_mode_fb_cmd2 *r,
|
||||||
struct drm_file *file_priv);
|
struct drm_file *file_priv);
|
||||||
void drm_framebuffer_free(struct kref *kref);
|
void drm_framebuffer_free(struct kref *kref);
|
||||||
|
int drm_framebuffer_check_src_coords(uint32_t src_x, uint32_t src_y,
|
||||||
|
uint32_t src_w, uint32_t src_h,
|
||||||
|
const struct drm_framebuffer *fb);
|
||||||
|
|
||||||
/* IOCTL */
|
/* IOCTL */
|
||||||
int drm_mode_addfb(struct drm_device *dev,
|
int drm_mode_addfb(struct drm_device *dev,
|
||||||
@ -180,3 +168,23 @@ void drm_modeset_unregister_all(struct drm_device *dev);
|
|||||||
/* drm_blend.c */
|
/* drm_blend.c */
|
||||||
int drm_atomic_normalize_zpos(struct drm_device *dev,
|
int drm_atomic_normalize_zpos(struct drm_device *dev,
|
||||||
struct drm_atomic_state *state);
|
struct drm_atomic_state *state);
|
||||||
|
|
||||||
|
/* drm_plane.c */
|
||||||
|
int drm_plane_register_all(struct drm_device *dev);
|
||||||
|
void drm_plane_unregister_all(struct drm_device *dev);
|
||||||
|
int drm_plane_check_pixel_format(const struct drm_plane *plane,
|
||||||
|
u32 format);
|
||||||
|
|
||||||
|
/* IOCTL */
|
||||||
|
int drm_mode_getplane_res(struct drm_device *dev, void *data,
|
||||||
|
struct drm_file *file_priv);
|
||||||
|
int drm_mode_getplane(struct drm_device *dev,
|
||||||
|
void *data, struct drm_file *file_priv);
|
||||||
|
int drm_mode_setplane(struct drm_device *dev,
|
||||||
|
void *data, struct drm_file *file_priv);
|
||||||
|
int drm_mode_cursor_ioctl(struct drm_device *dev,
|
||||||
|
void *data, struct drm_file *file_priv);
|
||||||
|
int drm_mode_cursor2_ioctl(struct drm_device *dev,
|
||||||
|
void *data, struct drm_file *file_priv);
|
||||||
|
int drm_mode_page_flip_ioctl(struct drm_device *dev,
|
||||||
|
void *data, struct drm_file *file_priv);
|
||||||
|
|||||||
@ -62,6 +62,32 @@
|
|||||||
* &drm_framebuffer.
|
* &drm_framebuffer.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
int drm_framebuffer_check_src_coords(uint32_t src_x, uint32_t src_y,
|
||||||
|
uint32_t src_w, uint32_t src_h,
|
||||||
|
const struct drm_framebuffer *fb)
|
||||||
|
{
|
||||||
|
unsigned int fb_width, fb_height;
|
||||||
|
|
||||||
|
fb_width = fb->width << 16;
|
||||||
|
fb_height = fb->height << 16;
|
||||||
|
|
||||||
|
/* Make sure source coordinates are inside the fb. */
|
||||||
|
if (src_w > fb_width ||
|
||||||
|
src_x > fb_width - src_w ||
|
||||||
|
src_h > fb_height ||
|
||||||
|
src_y > fb_height - src_h) {
|
||||||
|
DRM_DEBUG_KMS("Invalid source coordinates "
|
||||||
|
"%u.%06ux%u.%06u+%u.%06u+%u.%06u\n",
|
||||||
|
src_w >> 16, ((src_w & 0xffff) * 15625) >> 10,
|
||||||
|
src_h >> 16, ((src_h & 0xffff) * 15625) >> 10,
|
||||||
|
src_x >> 16, ((src_x & 0xffff) * 15625) >> 10,
|
||||||
|
src_y >> 16, ((src_y & 0xffff) * 15625) >> 10);
|
||||||
|
return -ENOSPC;
|
||||||
|
}
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* drm_mode_addfb - add an FB to the graphics configuration
|
* drm_mode_addfb - add an FB to the graphics configuration
|
||||||
* @dev: drm device for the ioctl
|
* @dev: drm device for the ioctl
|
||||||
|
|||||||
990
drivers/gpu/drm/drm_plane.c
Normal file
990
drivers/gpu/drm/drm_plane.c
Normal file
@ -0,0 +1,990 @@
|
|||||||
|
/*
|
||||||
|
* Copyright (c) 2016 Intel Corporation
|
||||||
|
*
|
||||||
|
* Permission to use, copy, modify, distribute, and sell this software and its
|
||||||
|
* documentation for any purpose is hereby granted without fee, provided that
|
||||||
|
* the above copyright notice appear in all copies and that both that copyright
|
||||||
|
* notice and this permission notice appear in supporting documentation, and
|
||||||
|
* that the name of the copyright holders not be used in advertising or
|
||||||
|
* publicity pertaining to distribution of the software without specific,
|
||||||
|
* written prior permission. The copyright holders make no representations
|
||||||
|
* about the suitability of this software for any purpose. It is provided "as
|
||||||
|
* is" without express or implied warranty.
|
||||||
|
*
|
||||||
|
* THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
||||||
|
* INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
||||||
|
* EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
||||||
|
* CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
||||||
|
* DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
||||||
|
* TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
|
||||||
|
* OF THIS SOFTWARE.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include <drm/drmP.h>
|
||||||
|
#include <drm/drm_plane.h>
|
||||||
|
|
||||||
|
#include "drm_crtc_internal.h"
|
||||||
|
|
||||||
|
static unsigned int drm_num_planes(struct drm_device *dev)
|
||||||
|
{
|
||||||
|
unsigned int num = 0;
|
||||||
|
struct drm_plane *tmp;
|
||||||
|
|
||||||
|
drm_for_each_plane(tmp, dev) {
|
||||||
|
num++;
|
||||||
|
}
|
||||||
|
|
||||||
|
return num;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_universal_plane_init - Initialize a new universal plane object
|
||||||
|
* @dev: DRM device
|
||||||
|
* @plane: plane object to init
|
||||||
|
* @possible_crtcs: bitmask of possible CRTCs
|
||||||
|
* @funcs: callbacks for the new plane
|
||||||
|
* @formats: array of supported formats (DRM_FORMAT\_\*)
|
||||||
|
* @format_count: number of elements in @formats
|
||||||
|
* @type: type of plane (overlay, primary, cursor)
|
||||||
|
* @name: printf style format string for the plane name, or NULL for default name
|
||||||
|
*
|
||||||
|
* Initializes a plane object of type @type.
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* Zero on success, error code on failure.
|
||||||
|
*/
|
||||||
|
int drm_universal_plane_init(struct drm_device *dev, struct drm_plane *plane,
|
||||||
|
unsigned long possible_crtcs,
|
||||||
|
const struct drm_plane_funcs *funcs,
|
||||||
|
const uint32_t *formats, unsigned int format_count,
|
||||||
|
enum drm_plane_type type,
|
||||||
|
const char *name, ...)
|
||||||
|
{
|
||||||
|
struct drm_mode_config *config = &dev->mode_config;
|
||||||
|
int ret;
|
||||||
|
|
||||||
|
ret = drm_mode_object_get(dev, &plane->base, DRM_MODE_OBJECT_PLANE);
|
||||||
|
if (ret)
|
||||||
|
return ret;
|
||||||
|
|
||||||
|
drm_modeset_lock_init(&plane->mutex);
|
||||||
|
|
||||||
|
plane->base.properties = &plane->properties;
|
||||||
|
plane->dev = dev;
|
||||||
|
plane->funcs = funcs;
|
||||||
|
plane->format_types = kmalloc_array(format_count, sizeof(uint32_t),
|
||||||
|
GFP_KERNEL);
|
||||||
|
if (!plane->format_types) {
|
||||||
|
DRM_DEBUG_KMS("out of memory when allocating plane\n");
|
||||||
|
drm_mode_object_unregister(dev, &plane->base);
|
||||||
|
return -ENOMEM;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (name) {
|
||||||
|
va_list ap;
|
||||||
|
|
||||||
|
va_start(ap, name);
|
||||||
|
plane->name = kvasprintf(GFP_KERNEL, name, ap);
|
||||||
|
va_end(ap);
|
||||||
|
} else {
|
||||||
|
plane->name = kasprintf(GFP_KERNEL, "plane-%d",
|
||||||
|
drm_num_planes(dev));
|
||||||
|
}
|
||||||
|
if (!plane->name) {
|
||||||
|
kfree(plane->format_types);
|
||||||
|
drm_mode_object_unregister(dev, &plane->base);
|
||||||
|
return -ENOMEM;
|
||||||
|
}
|
||||||
|
|
||||||
|
memcpy(plane->format_types, formats, format_count * sizeof(uint32_t));
|
||||||
|
plane->format_count = format_count;
|
||||||
|
plane->possible_crtcs = possible_crtcs;
|
||||||
|
plane->type = type;
|
||||||
|
|
||||||
|
list_add_tail(&plane->head, &config->plane_list);
|
||||||
|
plane->index = config->num_total_plane++;
|
||||||
|
if (plane->type == DRM_PLANE_TYPE_OVERLAY)
|
||||||
|
config->num_overlay_plane++;
|
||||||
|
|
||||||
|
drm_object_attach_property(&plane->base,
|
||||||
|
config->plane_type_property,
|
||||||
|
plane->type);
|
||||||
|
|
||||||
|
if (drm_core_check_feature(dev, DRIVER_ATOMIC)) {
|
||||||
|
drm_object_attach_property(&plane->base, config->prop_fb_id, 0);
|
||||||
|
drm_object_attach_property(&plane->base, config->prop_crtc_id, 0);
|
||||||
|
drm_object_attach_property(&plane->base, config->prop_crtc_x, 0);
|
||||||
|
drm_object_attach_property(&plane->base, config->prop_crtc_y, 0);
|
||||||
|
drm_object_attach_property(&plane->base, config->prop_crtc_w, 0);
|
||||||
|
drm_object_attach_property(&plane->base, config->prop_crtc_h, 0);
|
||||||
|
drm_object_attach_property(&plane->base, config->prop_src_x, 0);
|
||||||
|
drm_object_attach_property(&plane->base, config->prop_src_y, 0);
|
||||||
|
drm_object_attach_property(&plane->base, config->prop_src_w, 0);
|
||||||
|
drm_object_attach_property(&plane->base, config->prop_src_h, 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
EXPORT_SYMBOL(drm_universal_plane_init);
|
||||||
|
|
||||||
|
int drm_plane_register_all(struct drm_device *dev)
|
||||||
|
{
|
||||||
|
struct drm_plane *plane;
|
||||||
|
int ret = 0;
|
||||||
|
|
||||||
|
drm_for_each_plane(plane, dev) {
|
||||||
|
if (plane->funcs->late_register)
|
||||||
|
ret = plane->funcs->late_register(plane);
|
||||||
|
if (ret)
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
void drm_plane_unregister_all(struct drm_device *dev)
|
||||||
|
{
|
||||||
|
struct drm_plane *plane;
|
||||||
|
|
||||||
|
drm_for_each_plane(plane, dev) {
|
||||||
|
if (plane->funcs->early_unregister)
|
||||||
|
plane->funcs->early_unregister(plane);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_plane_init - Initialize a legacy plane
|
||||||
|
* @dev: DRM device
|
||||||
|
* @plane: plane object to init
|
||||||
|
* @possible_crtcs: bitmask of possible CRTCs
|
||||||
|
* @funcs: callbacks for the new plane
|
||||||
|
* @formats: array of supported formats (DRM_FORMAT\_\*)
|
||||||
|
* @format_count: number of elements in @formats
|
||||||
|
* @is_primary: plane type (primary vs overlay)
|
||||||
|
*
|
||||||
|
* Legacy API to initialize a DRM plane.
|
||||||
|
*
|
||||||
|
* New drivers should call drm_universal_plane_init() instead.
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* Zero on success, error code on failure.
|
||||||
|
*/
|
||||||
|
int drm_plane_init(struct drm_device *dev, struct drm_plane *plane,
|
||||||
|
unsigned long possible_crtcs,
|
||||||
|
const struct drm_plane_funcs *funcs,
|
||||||
|
const uint32_t *formats, unsigned int format_count,
|
||||||
|
bool is_primary)
|
||||||
|
{
|
||||||
|
enum drm_plane_type type;
|
||||||
|
|
||||||
|
type = is_primary ? DRM_PLANE_TYPE_PRIMARY : DRM_PLANE_TYPE_OVERLAY;
|
||||||
|
return drm_universal_plane_init(dev, plane, possible_crtcs, funcs,
|
||||||
|
formats, format_count, type, NULL);
|
||||||
|
}
|
||||||
|
EXPORT_SYMBOL(drm_plane_init);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_plane_cleanup - Clean up the core plane usage
|
||||||
|
* @plane: plane to cleanup
|
||||||
|
*
|
||||||
|
* This function cleans up @plane and removes it from the DRM mode setting
|
||||||
|
* core. Note that the function does *not* free the plane structure itself,
|
||||||
|
* this is the responsibility of the caller.
|
||||||
|
*/
|
||||||
|
void drm_plane_cleanup(struct drm_plane *plane)
|
||||||
|
{
|
||||||
|
struct drm_device *dev = plane->dev;
|
||||||
|
|
||||||
|
drm_modeset_lock_all(dev);
|
||||||
|
kfree(plane->format_types);
|
||||||
|
drm_mode_object_unregister(dev, &plane->base);
|
||||||
|
|
||||||
|
BUG_ON(list_empty(&plane->head));
|
||||||
|
|
||||||
|
/* Note that the plane_list is considered to be static; should we
|
||||||
|
* remove the drm_plane at runtime we would have to decrement all
|
||||||
|
* the indices on the drm_plane after us in the plane_list.
|
||||||
|
*/
|
||||||
|
|
||||||
|
list_del(&plane->head);
|
||||||
|
dev->mode_config.num_total_plane--;
|
||||||
|
if (plane->type == DRM_PLANE_TYPE_OVERLAY)
|
||||||
|
dev->mode_config.num_overlay_plane--;
|
||||||
|
drm_modeset_unlock_all(dev);
|
||||||
|
|
||||||
|
WARN_ON(plane->state && !plane->funcs->atomic_destroy_state);
|
||||||
|
if (plane->state && plane->funcs->atomic_destroy_state)
|
||||||
|
plane->funcs->atomic_destroy_state(plane, plane->state);
|
||||||
|
|
||||||
|
kfree(plane->name);
|
||||||
|
|
||||||
|
memset(plane, 0, sizeof(*plane));
|
||||||
|
}
|
||||||
|
EXPORT_SYMBOL(drm_plane_cleanup);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_plane_from_index - find the registered plane at an index
|
||||||
|
* @dev: DRM device
|
||||||
|
* @idx: index of registered plane to find for
|
||||||
|
*
|
||||||
|
* Given a plane index, return the registered plane from DRM device's
|
||||||
|
* list of planes with matching index.
|
||||||
|
*/
|
||||||
|
struct drm_plane *
|
||||||
|
drm_plane_from_index(struct drm_device *dev, int idx)
|
||||||
|
{
|
||||||
|
struct drm_plane *plane;
|
||||||
|
|
||||||
|
drm_for_each_plane(plane, dev)
|
||||||
|
if (idx == plane->index)
|
||||||
|
return plane;
|
||||||
|
|
||||||
|
return NULL;
|
||||||
|
}
|
||||||
|
EXPORT_SYMBOL(drm_plane_from_index);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_plane_force_disable - Forcibly disable a plane
|
||||||
|
* @plane: plane to disable
|
||||||
|
*
|
||||||
|
* Forces the plane to be disabled.
|
||||||
|
*
|
||||||
|
* Used when the plane's current framebuffer is destroyed,
|
||||||
|
* and when restoring fbdev mode.
|
||||||
|
*/
|
||||||
|
void drm_plane_force_disable(struct drm_plane *plane)
|
||||||
|
{
|
||||||
|
int ret;
|
||||||
|
|
||||||
|
if (!plane->fb)
|
||||||
|
return;
|
||||||
|
|
||||||
|
plane->old_fb = plane->fb;
|
||||||
|
ret = plane->funcs->disable_plane(plane);
|
||||||
|
if (ret) {
|
||||||
|
DRM_ERROR("failed to disable plane with busy fb\n");
|
||||||
|
plane->old_fb = NULL;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
/* disconnect the plane from the fb and crtc: */
|
||||||
|
drm_framebuffer_unreference(plane->old_fb);
|
||||||
|
plane->old_fb = NULL;
|
||||||
|
plane->fb = NULL;
|
||||||
|
plane->crtc = NULL;
|
||||||
|
}
|
||||||
|
EXPORT_SYMBOL(drm_plane_force_disable);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_mode_plane_set_obj_prop - set the value of a property
|
||||||
|
* @plane: drm plane object to set property value for
|
||||||
|
* @property: property to set
|
||||||
|
* @value: value the property should be set to
|
||||||
|
*
|
||||||
|
* This functions sets a given property on a given plane object. This function
|
||||||
|
* calls the driver's ->set_property callback and changes the software state of
|
||||||
|
* the property if the callback succeeds.
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* Zero on success, error code on failure.
|
||||||
|
*/
|
||||||
|
int drm_mode_plane_set_obj_prop(struct drm_plane *plane,
|
||||||
|
struct drm_property *property,
|
||||||
|
uint64_t value)
|
||||||
|
{
|
||||||
|
int ret = -EINVAL;
|
||||||
|
struct drm_mode_object *obj = &plane->base;
|
||||||
|
|
||||||
|
if (plane->funcs->set_property)
|
||||||
|
ret = plane->funcs->set_property(plane, property, value);
|
||||||
|
if (!ret)
|
||||||
|
drm_object_property_set_value(obj, property, value);
|
||||||
|
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
|
EXPORT_SYMBOL(drm_mode_plane_set_obj_prop);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_mode_getplane_res - enumerate all plane resources
|
||||||
|
* @dev: DRM device
|
||||||
|
* @data: ioctl data
|
||||||
|
* @file_priv: DRM file info
|
||||||
|
*
|
||||||
|
* Construct a list of plane ids to return to the user.
|
||||||
|
*
|
||||||
|
* Called by the user via ioctl.
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* Zero on success, negative errno on failure.
|
||||||
|
*/
|
||||||
|
int drm_mode_getplane_res(struct drm_device *dev, void *data,
|
||||||
|
struct drm_file *file_priv)
|
||||||
|
{
|
||||||
|
struct drm_mode_get_plane_res *plane_resp = data;
|
||||||
|
struct drm_mode_config *config;
|
||||||
|
struct drm_plane *plane;
|
||||||
|
uint32_t __user *plane_ptr;
|
||||||
|
int copied = 0;
|
||||||
|
unsigned num_planes;
|
||||||
|
|
||||||
|
if (!drm_core_check_feature(dev, DRIVER_MODESET))
|
||||||
|
return -EINVAL;
|
||||||
|
|
||||||
|
config = &dev->mode_config;
|
||||||
|
|
||||||
|
if (file_priv->universal_planes)
|
||||||
|
num_planes = config->num_total_plane;
|
||||||
|
else
|
||||||
|
num_planes = config->num_overlay_plane;
|
||||||
|
|
||||||
|
/*
|
||||||
|
* This ioctl is called twice, once to determine how much space is
|
||||||
|
* needed, and the 2nd time to fill it.
|
||||||
|
*/
|
||||||
|
if (num_planes &&
|
||||||
|
(plane_resp->count_planes >= num_planes)) {
|
||||||
|
plane_ptr = (uint32_t __user *)(unsigned long)plane_resp->plane_id_ptr;
|
||||||
|
|
||||||
|
/* Plane lists are invariant, no locking needed. */
|
||||||
|
drm_for_each_plane(plane, dev) {
|
||||||
|
/*
|
||||||
|
* Unless userspace set the 'universal planes'
|
||||||
|
* capability bit, only advertise overlays.
|
||||||
|
*/
|
||||||
|
if (plane->type != DRM_PLANE_TYPE_OVERLAY &&
|
||||||
|
!file_priv->universal_planes)
|
||||||
|
continue;
|
||||||
|
|
||||||
|
if (put_user(plane->base.id, plane_ptr + copied))
|
||||||
|
return -EFAULT;
|
||||||
|
copied++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
plane_resp->count_planes = num_planes;
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_mode_getplane - get plane configuration
|
||||||
|
* @dev: DRM device
|
||||||
|
* @data: ioctl data
|
||||||
|
* @file_priv: DRM file info
|
||||||
|
*
|
||||||
|
* Construct a plane configuration structure to return to the user.
|
||||||
|
*
|
||||||
|
* Called by the user via ioctl.
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* Zero on success, negative errno on failure.
|
||||||
|
*/
|
||||||
|
int drm_mode_getplane(struct drm_device *dev, void *data,
|
||||||
|
struct drm_file *file_priv)
|
||||||
|
{
|
||||||
|
struct drm_mode_get_plane *plane_resp = data;
|
||||||
|
struct drm_plane *plane;
|
||||||
|
uint32_t __user *format_ptr;
|
||||||
|
|
||||||
|
if (!drm_core_check_feature(dev, DRIVER_MODESET))
|
||||||
|
return -EINVAL;
|
||||||
|
|
||||||
|
plane = drm_plane_find(dev, plane_resp->plane_id);
|
||||||
|
if (!plane)
|
||||||
|
return -ENOENT;
|
||||||
|
|
||||||
|
drm_modeset_lock(&plane->mutex, NULL);
|
||||||
|
if (plane->crtc)
|
||||||
|
plane_resp->crtc_id = plane->crtc->base.id;
|
||||||
|
else
|
||||||
|
plane_resp->crtc_id = 0;
|
||||||
|
|
||||||
|
if (plane->fb)
|
||||||
|
plane_resp->fb_id = plane->fb->base.id;
|
||||||
|
else
|
||||||
|
plane_resp->fb_id = 0;
|
||||||
|
drm_modeset_unlock(&plane->mutex);
|
||||||
|
|
||||||
|
plane_resp->plane_id = plane->base.id;
|
||||||
|
plane_resp->possible_crtcs = plane->possible_crtcs;
|
||||||
|
plane_resp->gamma_size = 0;
|
||||||
|
|
||||||
|
/*
|
||||||
|
* This ioctl is called twice, once to determine how much space is
|
||||||
|
* needed, and the 2nd time to fill it.
|
||||||
|
*/
|
||||||
|
if (plane->format_count &&
|
||||||
|
(plane_resp->count_format_types >= plane->format_count)) {
|
||||||
|
format_ptr = (uint32_t __user *)(unsigned long)plane_resp->format_type_ptr;
|
||||||
|
if (copy_to_user(format_ptr,
|
||||||
|
plane->format_types,
|
||||||
|
sizeof(uint32_t) * plane->format_count)) {
|
||||||
|
return -EFAULT;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
plane_resp->count_format_types = plane->format_count;
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_plane_check_pixel_format - Check if the plane supports the pixel format
|
||||||
|
* @plane: plane to check for format support
|
||||||
|
* @format: the pixel format
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* Zero of @plane has @format in its list of supported pixel formats, -EINVAL
|
||||||
|
* otherwise.
|
||||||
|
*/
|
||||||
|
int drm_plane_check_pixel_format(const struct drm_plane *plane, u32 format)
|
||||||
|
{
|
||||||
|
unsigned int i;
|
||||||
|
|
||||||
|
for (i = 0; i < plane->format_count; i++) {
|
||||||
|
if (format == plane->format_types[i])
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
return -EINVAL;
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
* setplane_internal - setplane handler for internal callers
|
||||||
|
*
|
||||||
|
* Note that we assume an extra reference has already been taken on fb. If the
|
||||||
|
* update fails, this reference will be dropped before return; if it succeeds,
|
||||||
|
* the previous framebuffer (if any) will be unreferenced instead.
|
||||||
|
*
|
||||||
|
* src_{x,y,w,h} are provided in 16.16 fixed point format
|
||||||
|
*/
|
||||||
|
static int __setplane_internal(struct drm_plane *plane,
|
||||||
|
struct drm_crtc *crtc,
|
||||||
|
struct drm_framebuffer *fb,
|
||||||
|
int32_t crtc_x, int32_t crtc_y,
|
||||||
|
uint32_t crtc_w, uint32_t crtc_h,
|
||||||
|
/* src_{x,y,w,h} values are 16.16 fixed point */
|
||||||
|
uint32_t src_x, uint32_t src_y,
|
||||||
|
uint32_t src_w, uint32_t src_h)
|
||||||
|
{
|
||||||
|
int ret = 0;
|
||||||
|
|
||||||
|
/* No fb means shut it down */
|
||||||
|
if (!fb) {
|
||||||
|
plane->old_fb = plane->fb;
|
||||||
|
ret = plane->funcs->disable_plane(plane);
|
||||||
|
if (!ret) {
|
||||||
|
plane->crtc = NULL;
|
||||||
|
plane->fb = NULL;
|
||||||
|
} else {
|
||||||
|
plane->old_fb = NULL;
|
||||||
|
}
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Check whether this plane is usable on this CRTC */
|
||||||
|
if (!(plane->possible_crtcs & drm_crtc_mask(crtc))) {
|
||||||
|
DRM_DEBUG_KMS("Invalid crtc for plane\n");
|
||||||
|
ret = -EINVAL;
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Check whether this plane supports the fb pixel format. */
|
||||||
|
ret = drm_plane_check_pixel_format(plane, fb->pixel_format);
|
||||||
|
if (ret) {
|
||||||
|
char *format_name = drm_get_format_name(fb->pixel_format);
|
||||||
|
DRM_DEBUG_KMS("Invalid pixel format %s\n", format_name);
|
||||||
|
kfree(format_name);
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Give drivers some help against integer overflows */
|
||||||
|
if (crtc_w > INT_MAX ||
|
||||||
|
crtc_x > INT_MAX - (int32_t) crtc_w ||
|
||||||
|
crtc_h > INT_MAX ||
|
||||||
|
crtc_y > INT_MAX - (int32_t) crtc_h) {
|
||||||
|
DRM_DEBUG_KMS("Invalid CRTC coordinates %ux%u+%d+%d\n",
|
||||||
|
crtc_w, crtc_h, crtc_x, crtc_y);
|
||||||
|
ret = -ERANGE;
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
|
||||||
|
ret = drm_framebuffer_check_src_coords(src_x, src_y, src_w, src_h, fb);
|
||||||
|
if (ret)
|
||||||
|
goto out;
|
||||||
|
|
||||||
|
plane->old_fb = plane->fb;
|
||||||
|
ret = plane->funcs->update_plane(plane, crtc, fb,
|
||||||
|
crtc_x, crtc_y, crtc_w, crtc_h,
|
||||||
|
src_x, src_y, src_w, src_h);
|
||||||
|
if (!ret) {
|
||||||
|
plane->crtc = crtc;
|
||||||
|
plane->fb = fb;
|
||||||
|
fb = NULL;
|
||||||
|
} else {
|
||||||
|
plane->old_fb = NULL;
|
||||||
|
}
|
||||||
|
|
||||||
|
out:
|
||||||
|
if (fb)
|
||||||
|
drm_framebuffer_unreference(fb);
|
||||||
|
if (plane->old_fb)
|
||||||
|
drm_framebuffer_unreference(plane->old_fb);
|
||||||
|
plane->old_fb = NULL;
|
||||||
|
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
|
|
||||||
|
static int setplane_internal(struct drm_plane *plane,
|
||||||
|
struct drm_crtc *crtc,
|
||||||
|
struct drm_framebuffer *fb,
|
||||||
|
int32_t crtc_x, int32_t crtc_y,
|
||||||
|
uint32_t crtc_w, uint32_t crtc_h,
|
||||||
|
/* src_{x,y,w,h} values are 16.16 fixed point */
|
||||||
|
uint32_t src_x, uint32_t src_y,
|
||||||
|
uint32_t src_w, uint32_t src_h)
|
||||||
|
{
|
||||||
|
int ret;
|
||||||
|
|
||||||
|
drm_modeset_lock_all(plane->dev);
|
||||||
|
ret = __setplane_internal(plane, crtc, fb,
|
||||||
|
crtc_x, crtc_y, crtc_w, crtc_h,
|
||||||
|
src_x, src_y, src_w, src_h);
|
||||||
|
drm_modeset_unlock_all(plane->dev);
|
||||||
|
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_mode_setplane - configure a plane's configuration
|
||||||
|
* @dev: DRM device
|
||||||
|
* @data: ioctl data*
|
||||||
|
* @file_priv: DRM file info
|
||||||
|
*
|
||||||
|
* Set plane configuration, including placement, fb, scaling, and other factors.
|
||||||
|
* Or pass a NULL fb to disable (planes may be disabled without providing a
|
||||||
|
* valid crtc).
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* Zero on success, negative errno on failure.
|
||||||
|
*/
|
||||||
|
int drm_mode_setplane(struct drm_device *dev, void *data,
|
||||||
|
struct drm_file *file_priv)
|
||||||
|
{
|
||||||
|
struct drm_mode_set_plane *plane_req = data;
|
||||||
|
struct drm_plane *plane;
|
||||||
|
struct drm_crtc *crtc = NULL;
|
||||||
|
struct drm_framebuffer *fb = NULL;
|
||||||
|
|
||||||
|
if (!drm_core_check_feature(dev, DRIVER_MODESET))
|
||||||
|
return -EINVAL;
|
||||||
|
|
||||||
|
/*
|
||||||
|
* First, find the plane, crtc, and fb objects. If not available,
|
||||||
|
* we don't bother to call the driver.
|
||||||
|
*/
|
||||||
|
plane = drm_plane_find(dev, plane_req->plane_id);
|
||||||
|
if (!plane) {
|
||||||
|
DRM_DEBUG_KMS("Unknown plane ID %d\n",
|
||||||
|
plane_req->plane_id);
|
||||||
|
return -ENOENT;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (plane_req->fb_id) {
|
||||||
|
fb = drm_framebuffer_lookup(dev, plane_req->fb_id);
|
||||||
|
if (!fb) {
|
||||||
|
DRM_DEBUG_KMS("Unknown framebuffer ID %d\n",
|
||||||
|
plane_req->fb_id);
|
||||||
|
return -ENOENT;
|
||||||
|
}
|
||||||
|
|
||||||
|
crtc = drm_crtc_find(dev, plane_req->crtc_id);
|
||||||
|
if (!crtc) {
|
||||||
|
DRM_DEBUG_KMS("Unknown crtc ID %d\n",
|
||||||
|
plane_req->crtc_id);
|
||||||
|
return -ENOENT;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
* setplane_internal will take care of deref'ing either the old or new
|
||||||
|
* framebuffer depending on success.
|
||||||
|
*/
|
||||||
|
return setplane_internal(plane, crtc, fb,
|
||||||
|
plane_req->crtc_x, plane_req->crtc_y,
|
||||||
|
plane_req->crtc_w, plane_req->crtc_h,
|
||||||
|
plane_req->src_x, plane_req->src_y,
|
||||||
|
plane_req->src_w, plane_req->src_h);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_mode_cursor_universal - translate legacy cursor ioctl call into a
|
||||||
|
* universal plane handler call
|
||||||
|
* @crtc: crtc to update cursor for
|
||||||
|
* @req: data pointer for the ioctl
|
||||||
|
* @file_priv: drm file for the ioctl call
|
||||||
|
*
|
||||||
|
* Legacy cursor ioctl's work directly with driver buffer handles. To
|
||||||
|
* translate legacy ioctl calls into universal plane handler calls, we need to
|
||||||
|
* wrap the native buffer handle in a drm_framebuffer.
|
||||||
|
*
|
||||||
|
* Note that we assume any handle passed to the legacy ioctls was a 32-bit ARGB
|
||||||
|
* buffer with a pitch of 4*width; the universal plane interface should be used
|
||||||
|
* directly in cases where the hardware can support other buffer settings and
|
||||||
|
* userspace wants to make use of these capabilities.
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* Zero on success, negative errno on failure.
|
||||||
|
*/
|
||||||
|
static int drm_mode_cursor_universal(struct drm_crtc *crtc,
|
||||||
|
struct drm_mode_cursor2 *req,
|
||||||
|
struct drm_file *file_priv)
|
||||||
|
{
|
||||||
|
struct drm_device *dev = crtc->dev;
|
||||||
|
struct drm_framebuffer *fb = NULL;
|
||||||
|
struct drm_mode_fb_cmd2 fbreq = {
|
||||||
|
.width = req->width,
|
||||||
|
.height = req->height,
|
||||||
|
.pixel_format = DRM_FORMAT_ARGB8888,
|
||||||
|
.pitches = { req->width * 4 },
|
||||||
|
.handles = { req->handle },
|
||||||
|
};
|
||||||
|
int32_t crtc_x, crtc_y;
|
||||||
|
uint32_t crtc_w = 0, crtc_h = 0;
|
||||||
|
uint32_t src_w = 0, src_h = 0;
|
||||||
|
int ret = 0;
|
||||||
|
|
||||||
|
BUG_ON(!crtc->cursor);
|
||||||
|
WARN_ON(crtc->cursor->crtc != crtc && crtc->cursor->crtc != NULL);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Obtain fb we'll be using (either new or existing) and take an extra
|
||||||
|
* reference to it if fb != null. setplane will take care of dropping
|
||||||
|
* the reference if the plane update fails.
|
||||||
|
*/
|
||||||
|
if (req->flags & DRM_MODE_CURSOR_BO) {
|
||||||
|
if (req->handle) {
|
||||||
|
fb = drm_internal_framebuffer_create(dev, &fbreq, file_priv);
|
||||||
|
if (IS_ERR(fb)) {
|
||||||
|
DRM_DEBUG_KMS("failed to wrap cursor buffer in drm framebuffer\n");
|
||||||
|
return PTR_ERR(fb);
|
||||||
|
}
|
||||||
|
fb->hot_x = req->hot_x;
|
||||||
|
fb->hot_y = req->hot_y;
|
||||||
|
} else {
|
||||||
|
fb = NULL;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
fb = crtc->cursor->fb;
|
||||||
|
if (fb)
|
||||||
|
drm_framebuffer_reference(fb);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (req->flags & DRM_MODE_CURSOR_MOVE) {
|
||||||
|
crtc_x = req->x;
|
||||||
|
crtc_y = req->y;
|
||||||
|
} else {
|
||||||
|
crtc_x = crtc->cursor_x;
|
||||||
|
crtc_y = crtc->cursor_y;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (fb) {
|
||||||
|
crtc_w = fb->width;
|
||||||
|
crtc_h = fb->height;
|
||||||
|
src_w = fb->width << 16;
|
||||||
|
src_h = fb->height << 16;
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
* setplane_internal will take care of deref'ing either the old or new
|
||||||
|
* framebuffer depending on success.
|
||||||
|
*/
|
||||||
|
ret = __setplane_internal(crtc->cursor, crtc, fb,
|
||||||
|
crtc_x, crtc_y, crtc_w, crtc_h,
|
||||||
|
0, 0, src_w, src_h);
|
||||||
|
|
||||||
|
/* Update successful; save new cursor position, if necessary */
|
||||||
|
if (ret == 0 && req->flags & DRM_MODE_CURSOR_MOVE) {
|
||||||
|
crtc->cursor_x = req->x;
|
||||||
|
crtc->cursor_y = req->y;
|
||||||
|
}
|
||||||
|
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
|
|
||||||
|
static int drm_mode_cursor_common(struct drm_device *dev,
|
||||||
|
struct drm_mode_cursor2 *req,
|
||||||
|
struct drm_file *file_priv)
|
||||||
|
{
|
||||||
|
struct drm_crtc *crtc;
|
||||||
|
int ret = 0;
|
||||||
|
|
||||||
|
if (!drm_core_check_feature(dev, DRIVER_MODESET))
|
||||||
|
return -EINVAL;
|
||||||
|
|
||||||
|
if (!req->flags || (~DRM_MODE_CURSOR_FLAGS & req->flags))
|
||||||
|
return -EINVAL;
|
||||||
|
|
||||||
|
crtc = drm_crtc_find(dev, req->crtc_id);
|
||||||
|
if (!crtc) {
|
||||||
|
DRM_DEBUG_KMS("Unknown CRTC ID %d\n", req->crtc_id);
|
||||||
|
return -ENOENT;
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
* If this crtc has a universal cursor plane, call that plane's update
|
||||||
|
* handler rather than using legacy cursor handlers.
|
||||||
|
*/
|
||||||
|
drm_modeset_lock_crtc(crtc, crtc->cursor);
|
||||||
|
if (crtc->cursor) {
|
||||||
|
ret = drm_mode_cursor_universal(crtc, req, file_priv);
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (req->flags & DRM_MODE_CURSOR_BO) {
|
||||||
|
if (!crtc->funcs->cursor_set && !crtc->funcs->cursor_set2) {
|
||||||
|
ret = -ENXIO;
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
/* Turns off the cursor if handle is 0 */
|
||||||
|
if (crtc->funcs->cursor_set2)
|
||||||
|
ret = crtc->funcs->cursor_set2(crtc, file_priv, req->handle,
|
||||||
|
req->width, req->height, req->hot_x, req->hot_y);
|
||||||
|
else
|
||||||
|
ret = crtc->funcs->cursor_set(crtc, file_priv, req->handle,
|
||||||
|
req->width, req->height);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (req->flags & DRM_MODE_CURSOR_MOVE) {
|
||||||
|
if (crtc->funcs->cursor_move) {
|
||||||
|
ret = crtc->funcs->cursor_move(crtc, req->x, req->y);
|
||||||
|
} else {
|
||||||
|
ret = -EFAULT;
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
out:
|
||||||
|
drm_modeset_unlock_crtc(crtc);
|
||||||
|
|
||||||
|
return ret;
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_mode_cursor_ioctl - set CRTC's cursor configuration
|
||||||
|
* @dev: drm device for the ioctl
|
||||||
|
* @data: data pointer for the ioctl
|
||||||
|
* @file_priv: drm file for the ioctl call
|
||||||
|
*
|
||||||
|
* Set the cursor configuration based on user request.
|
||||||
|
*
|
||||||
|
* Called by the user via ioctl.
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* Zero on success, negative errno on failure.
|
||||||
|
*/
|
||||||
|
int drm_mode_cursor_ioctl(struct drm_device *dev,
|
||||||
|
void *data, struct drm_file *file_priv)
|
||||||
|
{
|
||||||
|
struct drm_mode_cursor *req = data;
|
||||||
|
struct drm_mode_cursor2 new_req;
|
||||||
|
|
||||||
|
memcpy(&new_req, req, sizeof(struct drm_mode_cursor));
|
||||||
|
new_req.hot_x = new_req.hot_y = 0;
|
||||||
|
|
||||||
|
return drm_mode_cursor_common(dev, &new_req, file_priv);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_mode_cursor2_ioctl - set CRTC's cursor configuration
|
||||||
|
* @dev: drm device for the ioctl
|
||||||
|
* @data: data pointer for the ioctl
|
||||||
|
* @file_priv: drm file for the ioctl call
|
||||||
|
*
|
||||||
|
* Set the cursor configuration based on user request. This implements the 2nd
|
||||||
|
* version of the cursor ioctl, which allows userspace to additionally specify
|
||||||
|
* the hotspot of the pointer.
|
||||||
|
*
|
||||||
|
* Called by the user via ioctl.
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* Zero on success, negative errno on failure.
|
||||||
|
*/
|
||||||
|
int drm_mode_cursor2_ioctl(struct drm_device *dev,
|
||||||
|
void *data, struct drm_file *file_priv)
|
||||||
|
{
|
||||||
|
struct drm_mode_cursor2 *req = data;
|
||||||
|
|
||||||
|
return drm_mode_cursor_common(dev, req, file_priv);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_mode_page_flip_ioctl - schedule an asynchronous fb update
|
||||||
|
* @dev: DRM device
|
||||||
|
* @data: ioctl data
|
||||||
|
* @file_priv: DRM file info
|
||||||
|
*
|
||||||
|
* This schedules an asynchronous update on a given CRTC, called page flip.
|
||||||
|
* Optionally a drm event is generated to signal the completion of the event.
|
||||||
|
* Generic drivers cannot assume that a pageflip with changed framebuffer
|
||||||
|
* properties (including driver specific metadata like tiling layout) will work,
|
||||||
|
* but some drivers support e.g. pixel format changes through the pageflip
|
||||||
|
* ioctl.
|
||||||
|
*
|
||||||
|
* Called by the user via ioctl.
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* Zero on success, negative errno on failure.
|
||||||
|
*/
|
||||||
|
int drm_mode_page_flip_ioctl(struct drm_device *dev,
|
||||||
|
void *data, struct drm_file *file_priv)
|
||||||
|
{
|
||||||
|
struct drm_mode_crtc_page_flip_target *page_flip = data;
|
||||||
|
struct drm_crtc *crtc;
|
||||||
|
struct drm_framebuffer *fb = NULL;
|
||||||
|
struct drm_pending_vblank_event *e = NULL;
|
||||||
|
u32 target_vblank = page_flip->sequence;
|
||||||
|
int ret = -EINVAL;
|
||||||
|
|
||||||
|
if (!drm_core_check_feature(dev, DRIVER_MODESET))
|
||||||
|
return -EINVAL;
|
||||||
|
|
||||||
|
if (page_flip->flags & ~DRM_MODE_PAGE_FLIP_FLAGS)
|
||||||
|
return -EINVAL;
|
||||||
|
|
||||||
|
if (page_flip->sequence != 0 && !(page_flip->flags & DRM_MODE_PAGE_FLIP_TARGET))
|
||||||
|
return -EINVAL;
|
||||||
|
|
||||||
|
/* Only one of the DRM_MODE_PAGE_FLIP_TARGET_ABSOLUTE/RELATIVE flags
|
||||||
|
* can be specified
|
||||||
|
*/
|
||||||
|
if ((page_flip->flags & DRM_MODE_PAGE_FLIP_TARGET) == DRM_MODE_PAGE_FLIP_TARGET)
|
||||||
|
return -EINVAL;
|
||||||
|
|
||||||
|
if ((page_flip->flags & DRM_MODE_PAGE_FLIP_ASYNC) && !dev->mode_config.async_page_flip)
|
||||||
|
return -EINVAL;
|
||||||
|
|
||||||
|
crtc = drm_crtc_find(dev, page_flip->crtc_id);
|
||||||
|
if (!crtc)
|
||||||
|
return -ENOENT;
|
||||||
|
|
||||||
|
drm_modeset_lock_crtc(crtc, crtc->primary);
|
||||||
|
if (crtc->primary->fb == NULL) {
|
||||||
|
/* The framebuffer is currently unbound, presumably
|
||||||
|
* due to a hotplug event, that userspace has not
|
||||||
|
* yet discovered.
|
||||||
|
*/
|
||||||
|
ret = -EBUSY;
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (crtc->funcs->page_flip == NULL)
|
||||||
|
goto out;
|
||||||
|
|
||||||
|
fb = drm_framebuffer_lookup(dev, page_flip->fb_id);
|
||||||
|
if (!fb) {
|
||||||
|
ret = -ENOENT;
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (crtc->state) {
|
||||||
|
const struct drm_plane_state *state = crtc->primary->state;
|
||||||
|
|
||||||
|
ret = drm_framebuffer_check_src_coords(state->src_x,
|
||||||
|
state->src_y,
|
||||||
|
state->src_w,
|
||||||
|
state->src_h,
|
||||||
|
fb);
|
||||||
|
} else {
|
||||||
|
ret = drm_crtc_check_viewport(crtc, crtc->x, crtc->y, &crtc->mode, fb);
|
||||||
|
}
|
||||||
|
if (ret)
|
||||||
|
goto out;
|
||||||
|
|
||||||
|
if (crtc->primary->fb->pixel_format != fb->pixel_format) {
|
||||||
|
DRM_DEBUG_KMS("Page flip is not allowed to change frame buffer format.\n");
|
||||||
|
ret = -EINVAL;
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (page_flip->flags & DRM_MODE_PAGE_FLIP_EVENT) {
|
||||||
|
e = kzalloc(sizeof *e, GFP_KERNEL);
|
||||||
|
if (!e) {
|
||||||
|
ret = -ENOMEM;
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
e->event.base.type = DRM_EVENT_FLIP_COMPLETE;
|
||||||
|
e->event.base.length = sizeof(e->event);
|
||||||
|
e->event.user_data = page_flip->user_data;
|
||||||
|
ret = drm_event_reserve_init(dev, file_priv, &e->base, &e->event.base);
|
||||||
|
if (ret) {
|
||||||
|
kfree(e);
|
||||||
|
goto out;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
crtc->primary->old_fb = crtc->primary->fb;
|
||||||
|
if (crtc->funcs->page_flip_target) {
|
||||||
|
u32 current_vblank;
|
||||||
|
int r;
|
||||||
|
|
||||||
|
r = drm_crtc_vblank_get(crtc);
|
||||||
|
if (r)
|
||||||
|
return r;
|
||||||
|
|
||||||
|
current_vblank = drm_crtc_vblank_count(crtc);
|
||||||
|
|
||||||
|
switch (page_flip->flags & DRM_MODE_PAGE_FLIP_TARGET) {
|
||||||
|
case DRM_MODE_PAGE_FLIP_TARGET_ABSOLUTE:
|
||||||
|
if ((int)(target_vblank - current_vblank) > 1) {
|
||||||
|
DRM_DEBUG("Invalid absolute flip target %u, "
|
||||||
|
"must be <= %u\n", target_vblank,
|
||||||
|
current_vblank + 1);
|
||||||
|
drm_crtc_vblank_put(crtc);
|
||||||
|
return -EINVAL;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
case DRM_MODE_PAGE_FLIP_TARGET_RELATIVE:
|
||||||
|
if (target_vblank != 0 && target_vblank != 1) {
|
||||||
|
DRM_DEBUG("Invalid relative flip target %u, "
|
||||||
|
"must be 0 or 1\n", target_vblank);
|
||||||
|
drm_crtc_vblank_put(crtc);
|
||||||
|
return -EINVAL;
|
||||||
|
}
|
||||||
|
target_vblank += current_vblank;
|
||||||
|
break;
|
||||||
|
default:
|
||||||
|
target_vblank = current_vblank +
|
||||||
|
!(page_flip->flags & DRM_MODE_PAGE_FLIP_ASYNC);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
} else if (crtc->funcs->page_flip == NULL ||
|
||||||
|
(page_flip->flags & DRM_MODE_PAGE_FLIP_TARGET)) {
|
||||||
|
return -EINVAL;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (crtc->funcs->page_flip_target)
|
||||||
|
ret = crtc->funcs->page_flip_target(crtc, fb, e,
|
||||||
|
page_flip->flags,
|
||||||
|
target_vblank);
|
||||||
|
else
|
||||||
|
ret = crtc->funcs->page_flip(crtc, fb, e, page_flip->flags);
|
||||||
|
if (ret) {
|
||||||
|
if (page_flip->flags & DRM_MODE_PAGE_FLIP_EVENT)
|
||||||
|
drm_event_cancel_free(dev, &e->base);
|
||||||
|
/* Keep the old fb, don't unref it. */
|
||||||
|
crtc->primary->old_fb = NULL;
|
||||||
|
} else {
|
||||||
|
crtc->primary->fb = fb;
|
||||||
|
/* Unref only the old framebuffer. */
|
||||||
|
fb = NULL;
|
||||||
|
}
|
||||||
|
|
||||||
|
out:
|
||||||
|
if (ret && crtc->funcs->page_flip_target)
|
||||||
|
drm_crtc_vblank_put(crtc);
|
||||||
|
if (crtc->primary->old_fb)
|
||||||
|
drm_framebuffer_unreference(crtc->primary->old_fb);
|
||||||
|
crtc->primary->old_fb = NULL;
|
||||||
|
drm_modeset_unlock_crtc(crtc);
|
||||||
|
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
@ -30,6 +30,160 @@
|
|||||||
|
|
||||||
#include <drm/drm_crtc.h>
|
#include <drm/drm_crtc.h>
|
||||||
|
|
||||||
|
/**
|
||||||
|
* struct drm_crtc_commit - track modeset commits on a CRTC
|
||||||
|
*
|
||||||
|
* This structure is used to track pending modeset changes and atomic commit on
|
||||||
|
* a per-CRTC basis. Since updating the list should never block this structure
|
||||||
|
* is reference counted to allow waiters to safely wait on an event to complete,
|
||||||
|
* without holding any locks.
|
||||||
|
*
|
||||||
|
* It has 3 different events in total to allow a fine-grained synchronization
|
||||||
|
* between outstanding updates::
|
||||||
|
*
|
||||||
|
* atomic commit thread hardware
|
||||||
|
*
|
||||||
|
* write new state into hardware ----> ...
|
||||||
|
* signal hw_done
|
||||||
|
* switch to new state on next
|
||||||
|
* ... v/hblank
|
||||||
|
*
|
||||||
|
* wait for buffers to show up ...
|
||||||
|
*
|
||||||
|
* ... send completion irq
|
||||||
|
* irq handler signals flip_done
|
||||||
|
* cleanup old buffers
|
||||||
|
*
|
||||||
|
* signal cleanup_done
|
||||||
|
*
|
||||||
|
* wait for flip_done <----
|
||||||
|
* clean up atomic state
|
||||||
|
*
|
||||||
|
* The important bit to know is that cleanup_done is the terminal event, but the
|
||||||
|
* ordering between flip_done and hw_done is entirely up to the specific driver
|
||||||
|
* and modeset state change.
|
||||||
|
*
|
||||||
|
* For an implementation of how to use this look at
|
||||||
|
* drm_atomic_helper_setup_commit() from the atomic helper library.
|
||||||
|
*/
|
||||||
|
struct drm_crtc_commit {
|
||||||
|
/**
|
||||||
|
* @crtc:
|
||||||
|
*
|
||||||
|
* DRM CRTC for this commit.
|
||||||
|
*/
|
||||||
|
struct drm_crtc *crtc;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ref:
|
||||||
|
*
|
||||||
|
* Reference count for this structure. Needed to allow blocking on
|
||||||
|
* completions without the risk of the completion disappearing
|
||||||
|
* meanwhile.
|
||||||
|
*/
|
||||||
|
struct kref ref;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @flip_done:
|
||||||
|
*
|
||||||
|
* Will be signaled when the hardware has flipped to the new set of
|
||||||
|
* buffers. Signals at the same time as when the drm event for this
|
||||||
|
* commit is sent to userspace, or when an out-fence is singalled. Note
|
||||||
|
* that for most hardware, in most cases this happens after @hw_done is
|
||||||
|
* signalled.
|
||||||
|
*/
|
||||||
|
struct completion flip_done;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @hw_done:
|
||||||
|
*
|
||||||
|
* Will be signalled when all hw register changes for this commit have
|
||||||
|
* been written out. Especially when disabling a pipe this can be much
|
||||||
|
* later than than @flip_done, since that can signal already when the
|
||||||
|
* screen goes black, whereas to fully shut down a pipe more register
|
||||||
|
* I/O is required.
|
||||||
|
*
|
||||||
|
* Note that this does not need to include separately reference-counted
|
||||||
|
* resources like backing storage buffer pinning, or runtime pm
|
||||||
|
* management.
|
||||||
|
*/
|
||||||
|
struct completion hw_done;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @cleanup_done:
|
||||||
|
*
|
||||||
|
* Will be signalled after old buffers have been cleaned up by calling
|
||||||
|
* drm_atomic_helper_cleanup_planes(). Since this can only happen after
|
||||||
|
* a vblank wait completed it might be a bit later. This completion is
|
||||||
|
* useful to throttle updates and avoid hardware updates getting ahead
|
||||||
|
* of the buffer cleanup too much.
|
||||||
|
*/
|
||||||
|
struct completion cleanup_done;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @commit_entry:
|
||||||
|
*
|
||||||
|
* Entry on the per-CRTC commit_list. Protected by crtc->commit_lock.
|
||||||
|
*/
|
||||||
|
struct list_head commit_entry;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @event:
|
||||||
|
*
|
||||||
|
* &drm_pending_vblank_event pointer to clean up private events.
|
||||||
|
*/
|
||||||
|
struct drm_pending_vblank_event *event;
|
||||||
|
};
|
||||||
|
|
||||||
|
struct __drm_planes_state {
|
||||||
|
struct drm_plane *ptr;
|
||||||
|
struct drm_plane_state *state;
|
||||||
|
};
|
||||||
|
|
||||||
|
struct __drm_crtcs_state {
|
||||||
|
struct drm_crtc *ptr;
|
||||||
|
struct drm_crtc_state *state;
|
||||||
|
struct drm_crtc_commit *commit;
|
||||||
|
};
|
||||||
|
|
||||||
|
struct __drm_connnectors_state {
|
||||||
|
struct drm_connector *ptr;
|
||||||
|
struct drm_connector_state *state;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* struct drm_atomic_state - the global state object for atomic updates
|
||||||
|
* @dev: parent DRM device
|
||||||
|
* @allow_modeset: allow full modeset
|
||||||
|
* @legacy_cursor_update: hint to enforce legacy cursor IOCTL semantics
|
||||||
|
* @legacy_set_config: Disable conflicting encoders instead of failing with -EINVAL.
|
||||||
|
* @planes: pointer to array of structures with per-plane data
|
||||||
|
* @crtcs: pointer to array of CRTC pointers
|
||||||
|
* @num_connector: size of the @connectors and @connector_states arrays
|
||||||
|
* @connectors: pointer to array of structures with per-connector data
|
||||||
|
* @acquire_ctx: acquire context for this atomic modeset state update
|
||||||
|
*/
|
||||||
|
struct drm_atomic_state {
|
||||||
|
struct drm_device *dev;
|
||||||
|
bool allow_modeset : 1;
|
||||||
|
bool legacy_cursor_update : 1;
|
||||||
|
bool legacy_set_config : 1;
|
||||||
|
struct __drm_planes_state *planes;
|
||||||
|
struct __drm_crtcs_state *crtcs;
|
||||||
|
int num_connector;
|
||||||
|
struct __drm_connnectors_state *connectors;
|
||||||
|
|
||||||
|
struct drm_modeset_acquire_ctx *acquire_ctx;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @commit_work:
|
||||||
|
*
|
||||||
|
* Work item which can be used by the driver or helpers to execute the
|
||||||
|
* commit without blocking.
|
||||||
|
*/
|
||||||
|
struct work_struct commit_work;
|
||||||
|
};
|
||||||
|
|
||||||
void drm_crtc_commit_put(struct drm_crtc_commit *commit);
|
void drm_crtc_commit_put(struct drm_crtc_commit *commit);
|
||||||
static inline void drm_crtc_commit_get(struct drm_crtc_commit *commit)
|
static inline void drm_crtc_commit_get(struct drm_crtc_commit *commit)
|
||||||
{
|
{
|
||||||
|
|||||||
@ -44,6 +44,7 @@
|
|||||||
#include <drm/drm_property.h>
|
#include <drm/drm_property.h>
|
||||||
#include <drm/drm_bridge.h>
|
#include <drm/drm_bridge.h>
|
||||||
#include <drm/drm_edid.h>
|
#include <drm/drm_edid.h>
|
||||||
|
#include <drm/drm_plane.h>
|
||||||
|
|
||||||
struct drm_device;
|
struct drm_device;
|
||||||
struct drm_mode_set;
|
struct drm_mode_set;
|
||||||
@ -656,525 +657,6 @@ struct drm_crtc {
|
|||||||
struct drm_modeset_acquire_ctx *acquire_ctx;
|
struct drm_modeset_acquire_ctx *acquire_ctx;
|
||||||
};
|
};
|
||||||
|
|
||||||
/**
|
|
||||||
* struct drm_plane_state - mutable plane state
|
|
||||||
* @plane: backpointer to the plane
|
|
||||||
* @crtc: currently bound CRTC, NULL if disabled
|
|
||||||
* @fb: currently bound framebuffer
|
|
||||||
* @fence: optional fence to wait for before scanning out @fb
|
|
||||||
* @crtc_x: left position of visible portion of plane on crtc
|
|
||||||
* @crtc_y: upper position of visible portion of plane on crtc
|
|
||||||
* @crtc_w: width of visible portion of plane on crtc
|
|
||||||
* @crtc_h: height of visible portion of plane on crtc
|
|
||||||
* @src_x: left position of visible portion of plane within
|
|
||||||
* plane (in 16.16)
|
|
||||||
* @src_y: upper position of visible portion of plane within
|
|
||||||
* plane (in 16.16)
|
|
||||||
* @src_w: width of visible portion of plane (in 16.16)
|
|
||||||
* @src_h: height of visible portion of plane (in 16.16)
|
|
||||||
* @rotation: rotation of the plane
|
|
||||||
* @zpos: priority of the given plane on crtc (optional)
|
|
||||||
* @normalized_zpos: normalized value of zpos: unique, range from 0 to N-1
|
|
||||||
* where N is the number of active planes for given crtc
|
|
||||||
* @src: clipped source coordinates of the plane (in 16.16)
|
|
||||||
* @dst: clipped destination coordinates of the plane
|
|
||||||
* @visible: visibility of the plane
|
|
||||||
* @state: backpointer to global drm_atomic_state
|
|
||||||
*/
|
|
||||||
struct drm_plane_state {
|
|
||||||
struct drm_plane *plane;
|
|
||||||
|
|
||||||
struct drm_crtc *crtc; /* do not write directly, use drm_atomic_set_crtc_for_plane() */
|
|
||||||
struct drm_framebuffer *fb; /* do not write directly, use drm_atomic_set_fb_for_plane() */
|
|
||||||
struct fence *fence;
|
|
||||||
|
|
||||||
/* Signed dest location allows it to be partially off screen */
|
|
||||||
int32_t crtc_x, crtc_y;
|
|
||||||
uint32_t crtc_w, crtc_h;
|
|
||||||
|
|
||||||
/* Source values are 16.16 fixed point */
|
|
||||||
uint32_t src_x, src_y;
|
|
||||||
uint32_t src_h, src_w;
|
|
||||||
|
|
||||||
/* Plane rotation */
|
|
||||||
unsigned int rotation;
|
|
||||||
|
|
||||||
/* Plane zpos */
|
|
||||||
unsigned int zpos;
|
|
||||||
unsigned int normalized_zpos;
|
|
||||||
|
|
||||||
/* Clipped coordinates */
|
|
||||||
struct drm_rect src, dst;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Is the plane actually visible? Can be false even
|
|
||||||
* if fb!=NULL and crtc!=NULL, due to clipping.
|
|
||||||
*/
|
|
||||||
bool visible;
|
|
||||||
|
|
||||||
struct drm_atomic_state *state;
|
|
||||||
};
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
|
||||||
* struct drm_plane_funcs - driver plane control functions
|
|
||||||
*/
|
|
||||||
struct drm_plane_funcs {
|
|
||||||
/**
|
|
||||||
* @update_plane:
|
|
||||||
*
|
|
||||||
* This is the legacy entry point to enable and configure the plane for
|
|
||||||
* the given CRTC and framebuffer. It is never called to disable the
|
|
||||||
* plane, i.e. the passed-in crtc and fb paramters are never NULL.
|
|
||||||
*
|
|
||||||
* The source rectangle in frame buffer memory coordinates is given by
|
|
||||||
* the src_x, src_y, src_w and src_h parameters (as 16.16 fixed point
|
|
||||||
* values). Devices that don't support subpixel plane coordinates can
|
|
||||||
* ignore the fractional part.
|
|
||||||
*
|
|
||||||
* The destination rectangle in CRTC coordinates is given by the
|
|
||||||
* crtc_x, crtc_y, crtc_w and crtc_h parameters (as integer values).
|
|
||||||
* Devices scale the source rectangle to the destination rectangle. If
|
|
||||||
* scaling is not supported, and the source rectangle size doesn't match
|
|
||||||
* the destination rectangle size, the driver must return a
|
|
||||||
* -<errorname>EINVAL</errorname> error.
|
|
||||||
*
|
|
||||||
* Drivers implementing atomic modeset should use
|
|
||||||
* drm_atomic_helper_update_plane() to implement this hook.
|
|
||||||
*
|
|
||||||
* RETURNS:
|
|
||||||
*
|
|
||||||
* 0 on success or a negative error code on failure.
|
|
||||||
*/
|
|
||||||
int (*update_plane)(struct drm_plane *plane,
|
|
||||||
struct drm_crtc *crtc, struct drm_framebuffer *fb,
|
|
||||||
int crtc_x, int crtc_y,
|
|
||||||
unsigned int crtc_w, unsigned int crtc_h,
|
|
||||||
uint32_t src_x, uint32_t src_y,
|
|
||||||
uint32_t src_w, uint32_t src_h);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @disable_plane:
|
|
||||||
*
|
|
||||||
* This is the legacy entry point to disable the plane. The DRM core
|
|
||||||
* calls this method in response to a DRM_IOCTL_MODE_SETPLANE IOCTL call
|
|
||||||
* with the frame buffer ID set to 0. Disabled planes must not be
|
|
||||||
* processed by the CRTC.
|
|
||||||
*
|
|
||||||
* Drivers implementing atomic modeset should use
|
|
||||||
* drm_atomic_helper_disable_plane() to implement this hook.
|
|
||||||
*
|
|
||||||
* RETURNS:
|
|
||||||
*
|
|
||||||
* 0 on success or a negative error code on failure.
|
|
||||||
*/
|
|
||||||
int (*disable_plane)(struct drm_plane *plane);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @destroy:
|
|
||||||
*
|
|
||||||
* Clean up plane resources. This is only called at driver unload time
|
|
||||||
* through drm_mode_config_cleanup() since a plane cannot be hotplugged
|
|
||||||
* in DRM.
|
|
||||||
*/
|
|
||||||
void (*destroy)(struct drm_plane *plane);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @reset:
|
|
||||||
*
|
|
||||||
* Reset plane hardware and software state to off. This function isn't
|
|
||||||
* called by the core directly, only through drm_mode_config_reset().
|
|
||||||
* It's not a helper hook only for historical reasons.
|
|
||||||
*
|
|
||||||
* Atomic drivers can use drm_atomic_helper_plane_reset() to reset
|
|
||||||
* atomic state using this hook.
|
|
||||||
*/
|
|
||||||
void (*reset)(struct drm_plane *plane);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @set_property:
|
|
||||||
*
|
|
||||||
* This is the legacy entry point to update a property attached to the
|
|
||||||
* plane.
|
|
||||||
*
|
|
||||||
* Drivers implementing atomic modeset should use
|
|
||||||
* drm_atomic_helper_plane_set_property() to implement this hook.
|
|
||||||
*
|
|
||||||
* This callback is optional if the driver does not support any legacy
|
|
||||||
* driver-private properties.
|
|
||||||
*
|
|
||||||
* RETURNS:
|
|
||||||
*
|
|
||||||
* 0 on success or a negative error code on failure.
|
|
||||||
*/
|
|
||||||
int (*set_property)(struct drm_plane *plane,
|
|
||||||
struct drm_property *property, uint64_t val);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @atomic_duplicate_state:
|
|
||||||
*
|
|
||||||
* Duplicate the current atomic state for this plane and return it.
|
|
||||||
* The core and helpers gurantee that any atomic state duplicated with
|
|
||||||
* this hook and still owned by the caller (i.e. not transferred to the
|
|
||||||
* driver by calling ->atomic_commit() from struct
|
|
||||||
* &drm_mode_config_funcs) will be cleaned up by calling the
|
|
||||||
* @atomic_destroy_state hook in this structure.
|
|
||||||
*
|
|
||||||
* Atomic drivers which don't subclass struct &drm_plane_state should use
|
|
||||||
* drm_atomic_helper_plane_duplicate_state(). Drivers that subclass the
|
|
||||||
* state structure to extend it with driver-private state should use
|
|
||||||
* __drm_atomic_helper_plane_duplicate_state() to make sure shared state is
|
|
||||||
* duplicated in a consistent fashion across drivers.
|
|
||||||
*
|
|
||||||
* It is an error to call this hook before plane->state has been
|
|
||||||
* initialized correctly.
|
|
||||||
*
|
|
||||||
* NOTE:
|
|
||||||
*
|
|
||||||
* If the duplicate state references refcounted resources this hook must
|
|
||||||
* acquire a reference for each of them. The driver must release these
|
|
||||||
* references again in @atomic_destroy_state.
|
|
||||||
*
|
|
||||||
* RETURNS:
|
|
||||||
*
|
|
||||||
* Duplicated atomic state or NULL when the allocation failed.
|
|
||||||
*/
|
|
||||||
struct drm_plane_state *(*atomic_duplicate_state)(struct drm_plane *plane);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @atomic_destroy_state:
|
|
||||||
*
|
|
||||||
* Destroy a state duplicated with @atomic_duplicate_state and release
|
|
||||||
* or unreference all resources it references
|
|
||||||
*/
|
|
||||||
void (*atomic_destroy_state)(struct drm_plane *plane,
|
|
||||||
struct drm_plane_state *state);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @atomic_set_property:
|
|
||||||
*
|
|
||||||
* Decode a driver-private property value and store the decoded value
|
|
||||||
* into the passed-in state structure. Since the atomic core decodes all
|
|
||||||
* standardized properties (even for extensions beyond the core set of
|
|
||||||
* properties which might not be implemented by all drivers) this
|
|
||||||
* requires drivers to subclass the state structure.
|
|
||||||
*
|
|
||||||
* Such driver-private properties should really only be implemented for
|
|
||||||
* truly hardware/vendor specific state. Instead it is preferred to
|
|
||||||
* standardize atomic extension and decode the properties used to expose
|
|
||||||
* such an extension in the core.
|
|
||||||
*
|
|
||||||
* Do not call this function directly, use
|
|
||||||
* drm_atomic_plane_set_property() instead.
|
|
||||||
*
|
|
||||||
* This callback is optional if the driver does not support any
|
|
||||||
* driver-private atomic properties.
|
|
||||||
*
|
|
||||||
* NOTE:
|
|
||||||
*
|
|
||||||
* This function is called in the state assembly phase of atomic
|
|
||||||
* modesets, which can be aborted for any reason (including on
|
|
||||||
* userspace's request to just check whether a configuration would be
|
|
||||||
* possible). Drivers MUST NOT touch any persistent state (hardware or
|
|
||||||
* software) or data structures except the passed in @state parameter.
|
|
||||||
*
|
|
||||||
* Also since userspace controls in which order properties are set this
|
|
||||||
* function must not do any input validation (since the state update is
|
|
||||||
* incomplete and hence likely inconsistent). Instead any such input
|
|
||||||
* validation must be done in the various atomic_check callbacks.
|
|
||||||
*
|
|
||||||
* RETURNS:
|
|
||||||
*
|
|
||||||
* 0 if the property has been found, -EINVAL if the property isn't
|
|
||||||
* implemented by the driver (which shouldn't ever happen, the core only
|
|
||||||
* asks for properties attached to this plane). No other validation is
|
|
||||||
* allowed by the driver. The core already checks that the property
|
|
||||||
* value is within the range (integer, valid enum value, ...) the driver
|
|
||||||
* set when registering the property.
|
|
||||||
*/
|
|
||||||
int (*atomic_set_property)(struct drm_plane *plane,
|
|
||||||
struct drm_plane_state *state,
|
|
||||||
struct drm_property *property,
|
|
||||||
uint64_t val);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @atomic_get_property:
|
|
||||||
*
|
|
||||||
* Reads out the decoded driver-private property. This is used to
|
|
||||||
* implement the GETPLANE IOCTL.
|
|
||||||
*
|
|
||||||
* Do not call this function directly, use
|
|
||||||
* drm_atomic_plane_get_property() instead.
|
|
||||||
*
|
|
||||||
* This callback is optional if the driver does not support any
|
|
||||||
* driver-private atomic properties.
|
|
||||||
*
|
|
||||||
* RETURNS:
|
|
||||||
*
|
|
||||||
* 0 on success, -EINVAL if the property isn't implemented by the
|
|
||||||
* driver (which should never happen, the core only asks for
|
|
||||||
* properties attached to this plane).
|
|
||||||
*/
|
|
||||||
int (*atomic_get_property)(struct drm_plane *plane,
|
|
||||||
const struct drm_plane_state *state,
|
|
||||||
struct drm_property *property,
|
|
||||||
uint64_t *val);
|
|
||||||
/**
|
|
||||||
* @late_register:
|
|
||||||
*
|
|
||||||
* This optional hook can be used to register additional userspace
|
|
||||||
* interfaces attached to the plane like debugfs interfaces.
|
|
||||||
* It is called late in the driver load sequence from drm_dev_register().
|
|
||||||
* Everything added from this callback should be unregistered in
|
|
||||||
* the early_unregister callback.
|
|
||||||
*
|
|
||||||
* Returns:
|
|
||||||
*
|
|
||||||
* 0 on success, or a negative error code on failure.
|
|
||||||
*/
|
|
||||||
int (*late_register)(struct drm_plane *plane);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @early_unregister:
|
|
||||||
*
|
|
||||||
* This optional hook should be used to unregister the additional
|
|
||||||
* userspace interfaces attached to the plane from
|
|
||||||
* late_unregister(). It is called from drm_dev_unregister(),
|
|
||||||
* early in the driver unload sequence to disable userspace access
|
|
||||||
* before data structures are torndown.
|
|
||||||
*/
|
|
||||||
void (*early_unregister)(struct drm_plane *plane);
|
|
||||||
};
|
|
||||||
|
|
||||||
enum drm_plane_type {
|
|
||||||
DRM_PLANE_TYPE_OVERLAY,
|
|
||||||
DRM_PLANE_TYPE_PRIMARY,
|
|
||||||
DRM_PLANE_TYPE_CURSOR,
|
|
||||||
};
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
|
||||||
* struct drm_plane - central DRM plane control structure
|
|
||||||
* @dev: DRM device this plane belongs to
|
|
||||||
* @head: for list management
|
|
||||||
* @name: human readable name, can be overwritten by the driver
|
|
||||||
* @base: base mode object
|
|
||||||
* @possible_crtcs: pipes this plane can be bound to
|
|
||||||
* @format_types: array of formats supported by this plane
|
|
||||||
* @format_count: number of formats supported
|
|
||||||
* @format_default: driver hasn't supplied supported formats for the plane
|
|
||||||
* @crtc: currently bound CRTC
|
|
||||||
* @fb: currently bound fb
|
|
||||||
* @old_fb: Temporary tracking of the old fb while a modeset is ongoing. Used by
|
|
||||||
* drm_mode_set_config_internal() to implement correct refcounting.
|
|
||||||
* @funcs: helper functions
|
|
||||||
* @properties: property tracking for this plane
|
|
||||||
* @type: type of plane (overlay, primary, cursor)
|
|
||||||
* @state: current atomic state for this plane
|
|
||||||
* @zpos_property: zpos property for this plane
|
|
||||||
* @helper_private: mid-layer private data
|
|
||||||
*/
|
|
||||||
struct drm_plane {
|
|
||||||
struct drm_device *dev;
|
|
||||||
struct list_head head;
|
|
||||||
|
|
||||||
char *name;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @mutex:
|
|
||||||
*
|
|
||||||
* Protects modeset plane state, together with the mutex of &drm_crtc
|
|
||||||
* this plane is linked to (when active, getting actived or getting
|
|
||||||
* disabled).
|
|
||||||
*/
|
|
||||||
struct drm_modeset_lock mutex;
|
|
||||||
|
|
||||||
struct drm_mode_object base;
|
|
||||||
|
|
||||||
uint32_t possible_crtcs;
|
|
||||||
uint32_t *format_types;
|
|
||||||
unsigned int format_count;
|
|
||||||
bool format_default;
|
|
||||||
|
|
||||||
struct drm_crtc *crtc;
|
|
||||||
struct drm_framebuffer *fb;
|
|
||||||
|
|
||||||
struct drm_framebuffer *old_fb;
|
|
||||||
|
|
||||||
const struct drm_plane_funcs *funcs;
|
|
||||||
|
|
||||||
struct drm_object_properties properties;
|
|
||||||
|
|
||||||
enum drm_plane_type type;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @index: Position inside the mode_config.list, can be used as an array
|
|
||||||
* index. It is invariant over the lifetime of the plane.
|
|
||||||
*/
|
|
||||||
unsigned index;
|
|
||||||
|
|
||||||
const struct drm_plane_helper_funcs *helper_private;
|
|
||||||
|
|
||||||
struct drm_plane_state *state;
|
|
||||||
|
|
||||||
struct drm_property *zpos_property;
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* struct drm_crtc_commit - track modeset commits on a CRTC
|
|
||||||
*
|
|
||||||
* This structure is used to track pending modeset changes and atomic commit on
|
|
||||||
* a per-CRTC basis. Since updating the list should never block this structure
|
|
||||||
* is reference counted to allow waiters to safely wait on an event to complete,
|
|
||||||
* without holding any locks.
|
|
||||||
*
|
|
||||||
* It has 3 different events in total to allow a fine-grained synchronization
|
|
||||||
* between outstanding updates::
|
|
||||||
*
|
|
||||||
* atomic commit thread hardware
|
|
||||||
*
|
|
||||||
* write new state into hardware ----> ...
|
|
||||||
* signal hw_done
|
|
||||||
* switch to new state on next
|
|
||||||
* ... v/hblank
|
|
||||||
*
|
|
||||||
* wait for buffers to show up ...
|
|
||||||
*
|
|
||||||
* ... send completion irq
|
|
||||||
* irq handler signals flip_done
|
|
||||||
* cleanup old buffers
|
|
||||||
*
|
|
||||||
* signal cleanup_done
|
|
||||||
*
|
|
||||||
* wait for flip_done <----
|
|
||||||
* clean up atomic state
|
|
||||||
*
|
|
||||||
* The important bit to know is that cleanup_done is the terminal event, but the
|
|
||||||
* ordering between flip_done and hw_done is entirely up to the specific driver
|
|
||||||
* and modeset state change.
|
|
||||||
*
|
|
||||||
* For an implementation of how to use this look at
|
|
||||||
* drm_atomic_helper_setup_commit() from the atomic helper library.
|
|
||||||
*/
|
|
||||||
struct drm_crtc_commit {
|
|
||||||
/**
|
|
||||||
* @crtc:
|
|
||||||
*
|
|
||||||
* DRM CRTC for this commit.
|
|
||||||
*/
|
|
||||||
struct drm_crtc *crtc;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ref:
|
|
||||||
*
|
|
||||||
* Reference count for this structure. Needed to allow blocking on
|
|
||||||
* completions without the risk of the completion disappearing
|
|
||||||
* meanwhile.
|
|
||||||
*/
|
|
||||||
struct kref ref;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @flip_done:
|
|
||||||
*
|
|
||||||
* Will be signaled when the hardware has flipped to the new set of
|
|
||||||
* buffers. Signals at the same time as when the drm event for this
|
|
||||||
* commit is sent to userspace, or when an out-fence is singalled. Note
|
|
||||||
* that for most hardware, in most cases this happens after @hw_done is
|
|
||||||
* signalled.
|
|
||||||
*/
|
|
||||||
struct completion flip_done;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @hw_done:
|
|
||||||
*
|
|
||||||
* Will be signalled when all hw register changes for this commit have
|
|
||||||
* been written out. Especially when disabling a pipe this can be much
|
|
||||||
* later than than @flip_done, since that can signal already when the
|
|
||||||
* screen goes black, whereas to fully shut down a pipe more register
|
|
||||||
* I/O is required.
|
|
||||||
*
|
|
||||||
* Note that this does not need to include separately reference-counted
|
|
||||||
* resources like backing storage buffer pinning, or runtime pm
|
|
||||||
* management.
|
|
||||||
*/
|
|
||||||
struct completion hw_done;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @cleanup_done:
|
|
||||||
*
|
|
||||||
* Will be signalled after old buffers have been cleaned up by calling
|
|
||||||
* drm_atomic_helper_cleanup_planes(). Since this can only happen after
|
|
||||||
* a vblank wait completed it might be a bit later. This completion is
|
|
||||||
* useful to throttle updates and avoid hardware updates getting ahead
|
|
||||||
* of the buffer cleanup too much.
|
|
||||||
*/
|
|
||||||
struct completion cleanup_done;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @commit_entry:
|
|
||||||
*
|
|
||||||
* Entry on the per-CRTC commit_list. Protected by crtc->commit_lock.
|
|
||||||
*/
|
|
||||||
struct list_head commit_entry;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @event:
|
|
||||||
*
|
|
||||||
* &drm_pending_vblank_event pointer to clean up private events.
|
|
||||||
*/
|
|
||||||
struct drm_pending_vblank_event *event;
|
|
||||||
};
|
|
||||||
|
|
||||||
struct __drm_planes_state {
|
|
||||||
struct drm_plane *ptr;
|
|
||||||
struct drm_plane_state *state;
|
|
||||||
};
|
|
||||||
|
|
||||||
struct __drm_crtcs_state {
|
|
||||||
struct drm_crtc *ptr;
|
|
||||||
struct drm_crtc_state *state;
|
|
||||||
struct drm_crtc_commit *commit;
|
|
||||||
};
|
|
||||||
|
|
||||||
struct __drm_connnectors_state {
|
|
||||||
struct drm_connector *ptr;
|
|
||||||
struct drm_connector_state *state;
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* struct drm_atomic_state - the global state object for atomic updates
|
|
||||||
* @dev: parent DRM device
|
|
||||||
* @allow_modeset: allow full modeset
|
|
||||||
* @legacy_cursor_update: hint to enforce legacy cursor IOCTL semantics
|
|
||||||
* @legacy_set_config: Disable conflicting encoders instead of failing with -EINVAL.
|
|
||||||
* @planes: pointer to array of structures with per-plane data
|
|
||||||
* @crtcs: pointer to array of CRTC pointers
|
|
||||||
* @num_connector: size of the @connectors and @connector_states arrays
|
|
||||||
* @connectors: pointer to array of structures with per-connector data
|
|
||||||
* @acquire_ctx: acquire context for this atomic modeset state update
|
|
||||||
*/
|
|
||||||
struct drm_atomic_state {
|
|
||||||
struct drm_device *dev;
|
|
||||||
bool allow_modeset : 1;
|
|
||||||
bool legacy_cursor_update : 1;
|
|
||||||
bool legacy_set_config : 1;
|
|
||||||
struct __drm_planes_state *planes;
|
|
||||||
struct __drm_crtcs_state *crtcs;
|
|
||||||
int num_connector;
|
|
||||||
struct __drm_connnectors_state *connectors;
|
|
||||||
|
|
||||||
struct drm_modeset_acquire_ctx *acquire_ctx;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @commit_work:
|
|
||||||
*
|
|
||||||
* Work item which can be used by the driver or helpers to execute the
|
|
||||||
* commit without blocking.
|
|
||||||
*/
|
|
||||||
struct work_struct commit_work;
|
|
||||||
};
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* struct drm_mode_set - new values for a CRTC config change
|
* struct drm_mode_set - new values for a CRTC config change
|
||||||
* @fb: framebuffer to use for new config
|
* @fb: framebuffer to use for new config
|
||||||
@ -1825,20 +1307,7 @@ struct drm_mode_config {
|
|||||||
struct drm_mode_config_helper_funcs *helper_private;
|
struct drm_mode_config_helper_funcs *helper_private;
|
||||||
};
|
};
|
||||||
|
|
||||||
/**
|
|
||||||
* drm_for_each_plane_mask - iterate over planes specified by bitmask
|
|
||||||
* @plane: the loop cursor
|
|
||||||
* @dev: the DRM device
|
|
||||||
* @plane_mask: bitmask of plane indices
|
|
||||||
*
|
|
||||||
* Iterate over all planes specified by bitmask.
|
|
||||||
*/
|
|
||||||
#define drm_for_each_plane_mask(plane, dev, plane_mask) \
|
|
||||||
list_for_each_entry((plane), &(dev)->mode_config.plane_list, head) \
|
|
||||||
for_each_if ((plane_mask) & (1 << drm_plane_index(plane)))
|
|
||||||
|
|
||||||
#define obj_to_crtc(x) container_of(x, struct drm_crtc, base)
|
#define obj_to_crtc(x) container_of(x, struct drm_crtc, base)
|
||||||
#define obj_to_plane(x) container_of(x, struct drm_plane, base)
|
|
||||||
|
|
||||||
extern __printf(6, 7)
|
extern __printf(6, 7)
|
||||||
int drm_crtc_init_with_planes(struct drm_device *dev,
|
int drm_crtc_init_with_planes(struct drm_device *dev,
|
||||||
@ -1873,36 +1342,6 @@ static inline uint32_t drm_crtc_mask(struct drm_crtc *crtc)
|
|||||||
return 1 << drm_crtc_index(crtc);
|
return 1 << drm_crtc_index(crtc);
|
||||||
}
|
}
|
||||||
|
|
||||||
extern __printf(8, 9)
|
|
||||||
int drm_universal_plane_init(struct drm_device *dev,
|
|
||||||
struct drm_plane *plane,
|
|
||||||
unsigned long possible_crtcs,
|
|
||||||
const struct drm_plane_funcs *funcs,
|
|
||||||
const uint32_t *formats,
|
|
||||||
unsigned int format_count,
|
|
||||||
enum drm_plane_type type,
|
|
||||||
const char *name, ...);
|
|
||||||
extern int drm_plane_init(struct drm_device *dev,
|
|
||||||
struct drm_plane *plane,
|
|
||||||
unsigned long possible_crtcs,
|
|
||||||
const struct drm_plane_funcs *funcs,
|
|
||||||
const uint32_t *formats, unsigned int format_count,
|
|
||||||
bool is_primary);
|
|
||||||
extern void drm_plane_cleanup(struct drm_plane *plane);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* drm_plane_index - find the index of a registered plane
|
|
||||||
* @plane: plane to find index for
|
|
||||||
*
|
|
||||||
* Given a registered plane, return the index of that plane within a DRM
|
|
||||||
* device's list of planes.
|
|
||||||
*/
|
|
||||||
static inline unsigned int drm_plane_index(struct drm_plane *plane)
|
|
||||||
{
|
|
||||||
return plane->index;
|
|
||||||
}
|
|
||||||
extern struct drm_plane * drm_plane_from_index(struct drm_device *dev, int idx);
|
|
||||||
extern void drm_plane_force_disable(struct drm_plane *plane);
|
|
||||||
extern void drm_crtc_get_hv_timing(const struct drm_display_mode *mode,
|
extern void drm_crtc_get_hv_timing(const struct drm_display_mode *mode,
|
||||||
int *hdisplay, int *vdisplay);
|
int *hdisplay, int *vdisplay);
|
||||||
extern int drm_crtc_force_disable(struct drm_crtc *crtc);
|
extern int drm_crtc_force_disable(struct drm_crtc *crtc);
|
||||||
@ -1924,10 +1363,6 @@ extern struct drm_tile_group *drm_mode_get_tile_group(struct drm_device *dev,
|
|||||||
extern void drm_mode_put_tile_group(struct drm_device *dev,
|
extern void drm_mode_put_tile_group(struct drm_device *dev,
|
||||||
struct drm_tile_group *tg);
|
struct drm_tile_group *tg);
|
||||||
|
|
||||||
extern int drm_mode_plane_set_obj_prop(struct drm_plane *plane,
|
|
||||||
struct drm_property *property,
|
|
||||||
uint64_t value);
|
|
||||||
|
|
||||||
extern struct drm_property *drm_mode_create_rotation_property(struct drm_device *dev,
|
extern struct drm_property *drm_mode_create_rotation_property(struct drm_device *dev,
|
||||||
unsigned int supported_rotations);
|
unsigned int supported_rotations);
|
||||||
extern unsigned int drm_rotation_simplify(unsigned int rotation,
|
extern unsigned int drm_rotation_simplify(unsigned int rotation,
|
||||||
@ -1945,14 +1380,6 @@ int drm_plane_create_zpos_immutable_property(struct drm_plane *plane,
|
|||||||
unsigned int zpos);
|
unsigned int zpos);
|
||||||
|
|
||||||
/* Helpers */
|
/* Helpers */
|
||||||
static inline struct drm_plane *drm_plane_find(struct drm_device *dev,
|
|
||||||
uint32_t id)
|
|
||||||
{
|
|
||||||
struct drm_mode_object *mo;
|
|
||||||
mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_PLANE);
|
|
||||||
return mo ? obj_to_plane(mo) : NULL;
|
|
||||||
}
|
|
||||||
|
|
||||||
static inline struct drm_crtc *drm_crtc_find(struct drm_device *dev,
|
static inline struct drm_crtc *drm_crtc_find(struct drm_device *dev,
|
||||||
uint32_t id)
|
uint32_t id)
|
||||||
{
|
{
|
||||||
@ -1980,14 +1407,6 @@ static inline uint32_t drm_color_lut_extract(uint32_t user_input,
|
|||||||
return clamp_val(val, 0, max);
|
return clamp_val(val, 0, max);
|
||||||
}
|
}
|
||||||
|
|
||||||
/* Plane list iterator for legacy (overlay only) planes. */
|
|
||||||
#define drm_for_each_legacy_plane(plane, dev) \
|
|
||||||
list_for_each_entry(plane, &(dev)->mode_config.plane_list, head) \
|
|
||||||
for_each_if (plane->type == DRM_PLANE_TYPE_OVERLAY)
|
|
||||||
|
|
||||||
#define drm_for_each_plane(plane, dev) \
|
|
||||||
list_for_each_entry(plane, &(dev)->mode_config.plane_list, head)
|
|
||||||
|
|
||||||
#define drm_for_each_crtc(crtc, dev) \
|
#define drm_for_each_crtc(crtc, dev) \
|
||||||
list_for_each_entry(crtc, &(dev)->mode_config.crtc_list, head)
|
list_for_each_entry(crtc, &(dev)->mode_config.crtc_list, head)
|
||||||
|
|
||||||
|
|||||||
470
include/drm/drm_plane.h
Normal file
470
include/drm/drm_plane.h
Normal file
@ -0,0 +1,470 @@
|
|||||||
|
/*
|
||||||
|
* Copyright (c) 2016 Intel Corporation
|
||||||
|
*
|
||||||
|
* Permission to use, copy, modify, distribute, and sell this software and its
|
||||||
|
* documentation for any purpose is hereby granted without fee, provided that
|
||||||
|
* the above copyright notice appear in all copies and that both that copyright
|
||||||
|
* notice and this permission notice appear in supporting documentation, and
|
||||||
|
* that the name of the copyright holders not be used in advertising or
|
||||||
|
* publicity pertaining to distribution of the software without specific,
|
||||||
|
* written prior permission. The copyright holders make no representations
|
||||||
|
* about the suitability of this software for any purpose. It is provided "as
|
||||||
|
* is" without express or implied warranty.
|
||||||
|
*
|
||||||
|
* THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
||||||
|
* INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
||||||
|
* EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
||||||
|
* CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
||||||
|
* DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
||||||
|
* TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
|
||||||
|
* OF THIS SOFTWARE.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef __DRM_PLANE_H__
|
||||||
|
#define __DRM_PLANE_H__
|
||||||
|
|
||||||
|
#include <linux/list.h>
|
||||||
|
#include <linux/ctype.h>
|
||||||
|
#include <drm/drm_mode_object.h>
|
||||||
|
|
||||||
|
struct drm_crtc;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* struct drm_plane_state - mutable plane state
|
||||||
|
* @plane: backpointer to the plane
|
||||||
|
* @crtc: currently bound CRTC, NULL if disabled
|
||||||
|
* @fb: currently bound framebuffer
|
||||||
|
* @fence: optional fence to wait for before scanning out @fb
|
||||||
|
* @crtc_x: left position of visible portion of plane on crtc
|
||||||
|
* @crtc_y: upper position of visible portion of plane on crtc
|
||||||
|
* @crtc_w: width of visible portion of plane on crtc
|
||||||
|
* @crtc_h: height of visible portion of plane on crtc
|
||||||
|
* @src_x: left position of visible portion of plane within
|
||||||
|
* plane (in 16.16)
|
||||||
|
* @src_y: upper position of visible portion of plane within
|
||||||
|
* plane (in 16.16)
|
||||||
|
* @src_w: width of visible portion of plane (in 16.16)
|
||||||
|
* @src_h: height of visible portion of plane (in 16.16)
|
||||||
|
* @rotation: rotation of the plane
|
||||||
|
* @zpos: priority of the given plane on crtc (optional)
|
||||||
|
* @normalized_zpos: normalized value of zpos: unique, range from 0 to N-1
|
||||||
|
* where N is the number of active planes for given crtc
|
||||||
|
* @src: clipped source coordinates of the plane (in 16.16)
|
||||||
|
* @dst: clipped destination coordinates of the plane
|
||||||
|
* @visible: visibility of the plane
|
||||||
|
* @state: backpointer to global drm_atomic_state
|
||||||
|
*/
|
||||||
|
struct drm_plane_state {
|
||||||
|
struct drm_plane *plane;
|
||||||
|
|
||||||
|
struct drm_crtc *crtc; /* do not write directly, use drm_atomic_set_crtc_for_plane() */
|
||||||
|
struct drm_framebuffer *fb; /* do not write directly, use drm_atomic_set_fb_for_plane() */
|
||||||
|
struct fence *fence;
|
||||||
|
|
||||||
|
/* Signed dest location allows it to be partially off screen */
|
||||||
|
int32_t crtc_x, crtc_y;
|
||||||
|
uint32_t crtc_w, crtc_h;
|
||||||
|
|
||||||
|
/* Source values are 16.16 fixed point */
|
||||||
|
uint32_t src_x, src_y;
|
||||||
|
uint32_t src_h, src_w;
|
||||||
|
|
||||||
|
/* Plane rotation */
|
||||||
|
unsigned int rotation;
|
||||||
|
|
||||||
|
/* Plane zpos */
|
||||||
|
unsigned int zpos;
|
||||||
|
unsigned int normalized_zpos;
|
||||||
|
|
||||||
|
/* Clipped coordinates */
|
||||||
|
struct drm_rect src, dst;
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Is the plane actually visible? Can be false even
|
||||||
|
* if fb!=NULL and crtc!=NULL, due to clipping.
|
||||||
|
*/
|
||||||
|
bool visible;
|
||||||
|
|
||||||
|
struct drm_atomic_state *state;
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* struct drm_plane_funcs - driver plane control functions
|
||||||
|
*/
|
||||||
|
struct drm_plane_funcs {
|
||||||
|
/**
|
||||||
|
* @update_plane:
|
||||||
|
*
|
||||||
|
* This is the legacy entry point to enable and configure the plane for
|
||||||
|
* the given CRTC and framebuffer. It is never called to disable the
|
||||||
|
* plane, i.e. the passed-in crtc and fb paramters are never NULL.
|
||||||
|
*
|
||||||
|
* The source rectangle in frame buffer memory coordinates is given by
|
||||||
|
* the src_x, src_y, src_w and src_h parameters (as 16.16 fixed point
|
||||||
|
* values). Devices that don't support subpixel plane coordinates can
|
||||||
|
* ignore the fractional part.
|
||||||
|
*
|
||||||
|
* The destination rectangle in CRTC coordinates is given by the
|
||||||
|
* crtc_x, crtc_y, crtc_w and crtc_h parameters (as integer values).
|
||||||
|
* Devices scale the source rectangle to the destination rectangle. If
|
||||||
|
* scaling is not supported, and the source rectangle size doesn't match
|
||||||
|
* the destination rectangle size, the driver must return a
|
||||||
|
* -<errorname>EINVAL</errorname> error.
|
||||||
|
*
|
||||||
|
* Drivers implementing atomic modeset should use
|
||||||
|
* drm_atomic_helper_update_plane() to implement this hook.
|
||||||
|
*
|
||||||
|
* RETURNS:
|
||||||
|
*
|
||||||
|
* 0 on success or a negative error code on failure.
|
||||||
|
*/
|
||||||
|
int (*update_plane)(struct drm_plane *plane,
|
||||||
|
struct drm_crtc *crtc, struct drm_framebuffer *fb,
|
||||||
|
int crtc_x, int crtc_y,
|
||||||
|
unsigned int crtc_w, unsigned int crtc_h,
|
||||||
|
uint32_t src_x, uint32_t src_y,
|
||||||
|
uint32_t src_w, uint32_t src_h);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @disable_plane:
|
||||||
|
*
|
||||||
|
* This is the legacy entry point to disable the plane. The DRM core
|
||||||
|
* calls this method in response to a DRM_IOCTL_MODE_SETPLANE IOCTL call
|
||||||
|
* with the frame buffer ID set to 0. Disabled planes must not be
|
||||||
|
* processed by the CRTC.
|
||||||
|
*
|
||||||
|
* Drivers implementing atomic modeset should use
|
||||||
|
* drm_atomic_helper_disable_plane() to implement this hook.
|
||||||
|
*
|
||||||
|
* RETURNS:
|
||||||
|
*
|
||||||
|
* 0 on success or a negative error code on failure.
|
||||||
|
*/
|
||||||
|
int (*disable_plane)(struct drm_plane *plane);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @destroy:
|
||||||
|
*
|
||||||
|
* Clean up plane resources. This is only called at driver unload time
|
||||||
|
* through drm_mode_config_cleanup() since a plane cannot be hotplugged
|
||||||
|
* in DRM.
|
||||||
|
*/
|
||||||
|
void (*destroy)(struct drm_plane *plane);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @reset:
|
||||||
|
*
|
||||||
|
* Reset plane hardware and software state to off. This function isn't
|
||||||
|
* called by the core directly, only through drm_mode_config_reset().
|
||||||
|
* It's not a helper hook only for historical reasons.
|
||||||
|
*
|
||||||
|
* Atomic drivers can use drm_atomic_helper_plane_reset() to reset
|
||||||
|
* atomic state using this hook.
|
||||||
|
*/
|
||||||
|
void (*reset)(struct drm_plane *plane);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @set_property:
|
||||||
|
*
|
||||||
|
* This is the legacy entry point to update a property attached to the
|
||||||
|
* plane.
|
||||||
|
*
|
||||||
|
* Drivers implementing atomic modeset should use
|
||||||
|
* drm_atomic_helper_plane_set_property() to implement this hook.
|
||||||
|
*
|
||||||
|
* This callback is optional if the driver does not support any legacy
|
||||||
|
* driver-private properties.
|
||||||
|
*
|
||||||
|
* RETURNS:
|
||||||
|
*
|
||||||
|
* 0 on success or a negative error code on failure.
|
||||||
|
*/
|
||||||
|
int (*set_property)(struct drm_plane *plane,
|
||||||
|
struct drm_property *property, uint64_t val);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @atomic_duplicate_state:
|
||||||
|
*
|
||||||
|
* Duplicate the current atomic state for this plane and return it.
|
||||||
|
* The core and helpers gurantee that any atomic state duplicated with
|
||||||
|
* this hook and still owned by the caller (i.e. not transferred to the
|
||||||
|
* driver by calling ->atomic_commit() from struct
|
||||||
|
* &drm_mode_config_funcs) will be cleaned up by calling the
|
||||||
|
* @atomic_destroy_state hook in this structure.
|
||||||
|
*
|
||||||
|
* Atomic drivers which don't subclass struct &drm_plane_state should use
|
||||||
|
* drm_atomic_helper_plane_duplicate_state(). Drivers that subclass the
|
||||||
|
* state structure to extend it with driver-private state should use
|
||||||
|
* __drm_atomic_helper_plane_duplicate_state() to make sure shared state is
|
||||||
|
* duplicated in a consistent fashion across drivers.
|
||||||
|
*
|
||||||
|
* It is an error to call this hook before plane->state has been
|
||||||
|
* initialized correctly.
|
||||||
|
*
|
||||||
|
* NOTE:
|
||||||
|
*
|
||||||
|
* If the duplicate state references refcounted resources this hook must
|
||||||
|
* acquire a reference for each of them. The driver must release these
|
||||||
|
* references again in @atomic_destroy_state.
|
||||||
|
*
|
||||||
|
* RETURNS:
|
||||||
|
*
|
||||||
|
* Duplicated atomic state or NULL when the allocation failed.
|
||||||
|
*/
|
||||||
|
struct drm_plane_state *(*atomic_duplicate_state)(struct drm_plane *plane);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @atomic_destroy_state:
|
||||||
|
*
|
||||||
|
* Destroy a state duplicated with @atomic_duplicate_state and release
|
||||||
|
* or unreference all resources it references
|
||||||
|
*/
|
||||||
|
void (*atomic_destroy_state)(struct drm_plane *plane,
|
||||||
|
struct drm_plane_state *state);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @atomic_set_property:
|
||||||
|
*
|
||||||
|
* Decode a driver-private property value and store the decoded value
|
||||||
|
* into the passed-in state structure. Since the atomic core decodes all
|
||||||
|
* standardized properties (even for extensions beyond the core set of
|
||||||
|
* properties which might not be implemented by all drivers) this
|
||||||
|
* requires drivers to subclass the state structure.
|
||||||
|
*
|
||||||
|
* Such driver-private properties should really only be implemented for
|
||||||
|
* truly hardware/vendor specific state. Instead it is preferred to
|
||||||
|
* standardize atomic extension and decode the properties used to expose
|
||||||
|
* such an extension in the core.
|
||||||
|
*
|
||||||
|
* Do not call this function directly, use
|
||||||
|
* drm_atomic_plane_set_property() instead.
|
||||||
|
*
|
||||||
|
* This callback is optional if the driver does not support any
|
||||||
|
* driver-private atomic properties.
|
||||||
|
*
|
||||||
|
* NOTE:
|
||||||
|
*
|
||||||
|
* This function is called in the state assembly phase of atomic
|
||||||
|
* modesets, which can be aborted for any reason (including on
|
||||||
|
* userspace's request to just check whether a configuration would be
|
||||||
|
* possible). Drivers MUST NOT touch any persistent state (hardware or
|
||||||
|
* software) or data structures except the passed in @state parameter.
|
||||||
|
*
|
||||||
|
* Also since userspace controls in which order properties are set this
|
||||||
|
* function must not do any input validation (since the state update is
|
||||||
|
* incomplete and hence likely inconsistent). Instead any such input
|
||||||
|
* validation must be done in the various atomic_check callbacks.
|
||||||
|
*
|
||||||
|
* RETURNS:
|
||||||
|
*
|
||||||
|
* 0 if the property has been found, -EINVAL if the property isn't
|
||||||
|
* implemented by the driver (which shouldn't ever happen, the core only
|
||||||
|
* asks for properties attached to this plane). No other validation is
|
||||||
|
* allowed by the driver. The core already checks that the property
|
||||||
|
* value is within the range (integer, valid enum value, ...) the driver
|
||||||
|
* set when registering the property.
|
||||||
|
*/
|
||||||
|
int (*atomic_set_property)(struct drm_plane *plane,
|
||||||
|
struct drm_plane_state *state,
|
||||||
|
struct drm_property *property,
|
||||||
|
uint64_t val);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @atomic_get_property:
|
||||||
|
*
|
||||||
|
* Reads out the decoded driver-private property. This is used to
|
||||||
|
* implement the GETPLANE IOCTL.
|
||||||
|
*
|
||||||
|
* Do not call this function directly, use
|
||||||
|
* drm_atomic_plane_get_property() instead.
|
||||||
|
*
|
||||||
|
* This callback is optional if the driver does not support any
|
||||||
|
* driver-private atomic properties.
|
||||||
|
*
|
||||||
|
* RETURNS:
|
||||||
|
*
|
||||||
|
* 0 on success, -EINVAL if the property isn't implemented by the
|
||||||
|
* driver (which should never happen, the core only asks for
|
||||||
|
* properties attached to this plane).
|
||||||
|
*/
|
||||||
|
int (*atomic_get_property)(struct drm_plane *plane,
|
||||||
|
const struct drm_plane_state *state,
|
||||||
|
struct drm_property *property,
|
||||||
|
uint64_t *val);
|
||||||
|
/**
|
||||||
|
* @late_register:
|
||||||
|
*
|
||||||
|
* This optional hook can be used to register additional userspace
|
||||||
|
* interfaces attached to the plane like debugfs interfaces.
|
||||||
|
* It is called late in the driver load sequence from drm_dev_register().
|
||||||
|
* Everything added from this callback should be unregistered in
|
||||||
|
* the early_unregister callback.
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
*
|
||||||
|
* 0 on success, or a negative error code on failure.
|
||||||
|
*/
|
||||||
|
int (*late_register)(struct drm_plane *plane);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @early_unregister:
|
||||||
|
*
|
||||||
|
* This optional hook should be used to unregister the additional
|
||||||
|
* userspace interfaces attached to the plane from
|
||||||
|
* late_unregister(). It is called from drm_dev_unregister(),
|
||||||
|
* early in the driver unload sequence to disable userspace access
|
||||||
|
* before data structures are torndown.
|
||||||
|
*/
|
||||||
|
void (*early_unregister)(struct drm_plane *plane);
|
||||||
|
};
|
||||||
|
|
||||||
|
enum drm_plane_type {
|
||||||
|
DRM_PLANE_TYPE_OVERLAY,
|
||||||
|
DRM_PLANE_TYPE_PRIMARY,
|
||||||
|
DRM_PLANE_TYPE_CURSOR,
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* struct drm_plane - central DRM plane control structure
|
||||||
|
* @dev: DRM device this plane belongs to
|
||||||
|
* @head: for list management
|
||||||
|
* @name: human readable name, can be overwritten by the driver
|
||||||
|
* @base: base mode object
|
||||||
|
* @possible_crtcs: pipes this plane can be bound to
|
||||||
|
* @format_types: array of formats supported by this plane
|
||||||
|
* @format_count: number of formats supported
|
||||||
|
* @format_default: driver hasn't supplied supported formats for the plane
|
||||||
|
* @crtc: currently bound CRTC
|
||||||
|
* @fb: currently bound fb
|
||||||
|
* @old_fb: Temporary tracking of the old fb while a modeset is ongoing. Used by
|
||||||
|
* drm_mode_set_config_internal() to implement correct refcounting.
|
||||||
|
* @funcs: helper functions
|
||||||
|
* @properties: property tracking for this plane
|
||||||
|
* @type: type of plane (overlay, primary, cursor)
|
||||||
|
* @state: current atomic state for this plane
|
||||||
|
* @zpos_property: zpos property for this plane
|
||||||
|
* @helper_private: mid-layer private data
|
||||||
|
*/
|
||||||
|
struct drm_plane {
|
||||||
|
struct drm_device *dev;
|
||||||
|
struct list_head head;
|
||||||
|
|
||||||
|
char *name;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @mutex:
|
||||||
|
*
|
||||||
|
* Protects modeset plane state, together with the mutex of &drm_crtc
|
||||||
|
* this plane is linked to (when active, getting actived or getting
|
||||||
|
* disabled).
|
||||||
|
*/
|
||||||
|
struct drm_modeset_lock mutex;
|
||||||
|
|
||||||
|
struct drm_mode_object base;
|
||||||
|
|
||||||
|
uint32_t possible_crtcs;
|
||||||
|
uint32_t *format_types;
|
||||||
|
unsigned int format_count;
|
||||||
|
bool format_default;
|
||||||
|
|
||||||
|
struct drm_crtc *crtc;
|
||||||
|
struct drm_framebuffer *fb;
|
||||||
|
|
||||||
|
struct drm_framebuffer *old_fb;
|
||||||
|
|
||||||
|
const struct drm_plane_funcs *funcs;
|
||||||
|
|
||||||
|
struct drm_object_properties properties;
|
||||||
|
|
||||||
|
enum drm_plane_type type;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @index: Position inside the mode_config.list, can be used as an array
|
||||||
|
* index. It is invariant over the lifetime of the plane.
|
||||||
|
*/
|
||||||
|
unsigned index;
|
||||||
|
|
||||||
|
const struct drm_plane_helper_funcs *helper_private;
|
||||||
|
|
||||||
|
struct drm_plane_state *state;
|
||||||
|
|
||||||
|
struct drm_property *zpos_property;
|
||||||
|
};
|
||||||
|
|
||||||
|
#define obj_to_plane(x) container_of(x, struct drm_plane, base)
|
||||||
|
|
||||||
|
extern __printf(8, 9)
|
||||||
|
int drm_universal_plane_init(struct drm_device *dev,
|
||||||
|
struct drm_plane *plane,
|
||||||
|
unsigned long possible_crtcs,
|
||||||
|
const struct drm_plane_funcs *funcs,
|
||||||
|
const uint32_t *formats,
|
||||||
|
unsigned int format_count,
|
||||||
|
enum drm_plane_type type,
|
||||||
|
const char *name, ...);
|
||||||
|
extern int drm_plane_init(struct drm_device *dev,
|
||||||
|
struct drm_plane *plane,
|
||||||
|
unsigned long possible_crtcs,
|
||||||
|
const struct drm_plane_funcs *funcs,
|
||||||
|
const uint32_t *formats, unsigned int format_count,
|
||||||
|
bool is_primary);
|
||||||
|
extern void drm_plane_cleanup(struct drm_plane *plane);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_plane_index - find the index of a registered plane
|
||||||
|
* @plane: plane to find index for
|
||||||
|
*
|
||||||
|
* Given a registered plane, return the index of that plane within a DRM
|
||||||
|
* device's list of planes.
|
||||||
|
*/
|
||||||
|
static inline unsigned int drm_plane_index(struct drm_plane *plane)
|
||||||
|
{
|
||||||
|
return plane->index;
|
||||||
|
}
|
||||||
|
extern struct drm_plane * drm_plane_from_index(struct drm_device *dev, int idx);
|
||||||
|
extern void drm_plane_force_disable(struct drm_plane *plane);
|
||||||
|
|
||||||
|
int drm_mode_plane_set_obj_prop(struct drm_plane *plane,
|
||||||
|
struct drm_property *property,
|
||||||
|
uint64_t value);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_plane_find - find a &drm_plane
|
||||||
|
* @dev: DRM device
|
||||||
|
* @id: plane id
|
||||||
|
*
|
||||||
|
* Returns the plane with @id, NULL if it doesn't exist. Simple wrapper around
|
||||||
|
* drm_mode_object_find().
|
||||||
|
*/
|
||||||
|
static inline struct drm_plane *drm_plane_find(struct drm_device *dev,
|
||||||
|
uint32_t id)
|
||||||
|
{
|
||||||
|
struct drm_mode_object *mo;
|
||||||
|
mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_PLANE);
|
||||||
|
return mo ? obj_to_plane(mo) : NULL;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* drm_for_each_plane_mask - iterate over planes specified by bitmask
|
||||||
|
* @plane: the loop cursor
|
||||||
|
* @dev: the DRM device
|
||||||
|
* @plane_mask: bitmask of plane indices
|
||||||
|
*
|
||||||
|
* Iterate over all planes specified by bitmask.
|
||||||
|
*/
|
||||||
|
#define drm_for_each_plane_mask(plane, dev, plane_mask) \
|
||||||
|
list_for_each_entry((plane), &(dev)->mode_config.plane_list, head) \
|
||||||
|
for_each_if ((plane_mask) & (1 << drm_plane_index(plane)))
|
||||||
|
|
||||||
|
/* Plane list iterator for legacy (overlay only) planes. */
|
||||||
|
#define drm_for_each_legacy_plane(plane, dev) \
|
||||||
|
list_for_each_entry(plane, &(dev)->mode_config.plane_list, head) \
|
||||||
|
for_each_if (plane->type == DRM_PLANE_TYPE_OVERLAY)
|
||||||
|
|
||||||
|
#define drm_for_each_plane(plane, dev) \
|
||||||
|
list_for_each_entry(plane, &(dev)->mode_config.plane_list, head)
|
||||||
|
|
||||||
|
|
||||||
|
#endif
|
||||||
Loading…
x
Reference in New Issue
Block a user