e6fc3b6855
This is the plumbing for supporting fb modifiers on planes. Modifiers have already been introduced to some extent, but this series will extend this to allow querying modifiers per plane. Based on this, the client to enable optimal modifications for framebuffers. This patch simply allows the DRM drivers to initialize their list of supported modifiers upon initializing the plane. v2: A minor addition from Daniel v3: * Updated commit message * s/INVALID/DRM_FORMAT_MOD_INVALID (Liviu) * Remove some excess newlines (Liviu) * Update comment for > 64 modifiers (Liviu) v4: Minor comment adjustments (Liviu) v5: Some new platforms added due to rebase v6: Add some missed plane inits (or maybe they're new - who knows at this point) (Daniel) Signed-off-by: Ben Widawsky <ben@bwidawsk.net> Reviewed-by: Daniel Stone <daniels@collabora.com> (v2) Reviewed-by: Liviu Dudau <Liviu.Dudau@arm.com> Signed-off-by: Daniel Stone <daniels@collabora.com>
129 lines
4.0 KiB
C
129 lines
4.0 KiB
C
/*
|
|
* Copyright (C) 2016 Noralf Trønnes
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*/
|
|
|
|
#ifndef __LINUX_DRM_SIMPLE_KMS_HELPER_H
|
|
#define __LINUX_DRM_SIMPLE_KMS_HELPER_H
|
|
|
|
#include <drm/drm_crtc.h>
|
|
#include <drm/drm_encoder.h>
|
|
#include <drm/drm_plane.h>
|
|
|
|
struct drm_simple_display_pipe;
|
|
|
|
/**
|
|
* struct drm_simple_display_pipe_funcs - helper operations for a simple
|
|
* display pipeline
|
|
*/
|
|
struct drm_simple_display_pipe_funcs {
|
|
/**
|
|
* @enable:
|
|
*
|
|
* This function should be used to enable the pipeline.
|
|
* It is called when the underlying crtc is enabled.
|
|
* This hook is optional.
|
|
*/
|
|
void (*enable)(struct drm_simple_display_pipe *pipe,
|
|
struct drm_crtc_state *crtc_state);
|
|
/**
|
|
* @disable:
|
|
*
|
|
* This function should be used to disable the pipeline.
|
|
* It is called when the underlying crtc is disabled.
|
|
* This hook is optional.
|
|
*/
|
|
void (*disable)(struct drm_simple_display_pipe *pipe);
|
|
|
|
/**
|
|
* @check:
|
|
*
|
|
* This function is called in the check phase of an atomic update,
|
|
* specifically when the underlying plane is checked.
|
|
* The simple display pipeline helpers already check that the plane is
|
|
* not scaled, fills the entire visible area and is always enabled
|
|
* when the crtc is also enabled.
|
|
* This hook is optional.
|
|
*
|
|
* RETURNS:
|
|
*
|
|
* 0 on success, -EINVAL if the state or the transition can't be
|
|
* supported, -ENOMEM on memory allocation failure and -EDEADLK if an
|
|
* attempt to obtain another state object ran into a &drm_modeset_lock
|
|
* deadlock.
|
|
*/
|
|
int (*check)(struct drm_simple_display_pipe *pipe,
|
|
struct drm_plane_state *plane_state,
|
|
struct drm_crtc_state *crtc_state);
|
|
/**
|
|
* @update:
|
|
*
|
|
* This function is called when the underlying plane state is updated.
|
|
* This hook is optional.
|
|
*
|
|
* This is the function drivers should submit the
|
|
* &drm_pending_vblank_event from. Using either
|
|
* drm_crtc_arm_vblank_event(), when the driver supports vblank
|
|
* interrupt handling, or drm_crtc_send_vblank_event() directly in case
|
|
* the hardware lacks vblank support entirely.
|
|
*/
|
|
void (*update)(struct drm_simple_display_pipe *pipe,
|
|
struct drm_plane_state *old_plane_state);
|
|
|
|
/**
|
|
* @prepare_fb:
|
|
*
|
|
* Optional, called by &drm_plane_helper_funcs.prepare_fb. Please read
|
|
* the documentation for the &drm_plane_helper_funcs.prepare_fb hook for
|
|
* more details.
|
|
*/
|
|
int (*prepare_fb)(struct drm_simple_display_pipe *pipe,
|
|
struct drm_plane_state *plane_state);
|
|
|
|
/**
|
|
* @cleanup_fb:
|
|
*
|
|
* Optional, called by &drm_plane_helper_funcs.cleanup_fb. Please read
|
|
* the documentation for the &drm_plane_helper_funcs.cleanup_fb hook for
|
|
* more details.
|
|
*/
|
|
void (*cleanup_fb)(struct drm_simple_display_pipe *pipe,
|
|
struct drm_plane_state *plane_state);
|
|
};
|
|
|
|
/**
|
|
* struct drm_simple_display_pipe - simple display pipeline
|
|
* @crtc: CRTC control structure
|
|
* @plane: Plane control structure
|
|
* @encoder: Encoder control structure
|
|
* @connector: Connector control structure
|
|
* @funcs: Pipeline control functions (optional)
|
|
*
|
|
* Simple display pipeline with plane, crtc and encoder collapsed into one
|
|
* entity. It should be initialized by calling drm_simple_display_pipe_init().
|
|
*/
|
|
struct drm_simple_display_pipe {
|
|
struct drm_crtc crtc;
|
|
struct drm_plane plane;
|
|
struct drm_encoder encoder;
|
|
struct drm_connector *connector;
|
|
|
|
const struct drm_simple_display_pipe_funcs *funcs;
|
|
};
|
|
|
|
int drm_simple_display_pipe_attach_bridge(struct drm_simple_display_pipe *pipe,
|
|
struct drm_bridge *bridge);
|
|
|
|
int drm_simple_display_pipe_init(struct drm_device *dev,
|
|
struct drm_simple_display_pipe *pipe,
|
|
const struct drm_simple_display_pipe_funcs *funcs,
|
|
const uint32_t *formats, unsigned int format_count,
|
|
const uint64_t *format_modifiers,
|
|
struct drm_connector *connector);
|
|
|
|
#endif /* __LINUX_DRM_SIMPLE_KMS_HELPER_H */
|