blob: e1b07c23f5b92b510a8caea797ad00b011d158e2 [file] [log] [blame]
/*
* Copyright (c) 2015-2017, The Linux Foundation. All rights reserved.
* Copyright (C) 2013 Red Hat
* Author: Rob Clark <robdclark@gmail.com>
*
* This program is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 as published by
* the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along with
* this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef _SDE_PLANE_H_
#define _SDE_PLANE_H_
#include <drm/drm_crtc.h>
#include "msm_prop.h"
#include "sde_kms.h"
#include "sde_hw_mdss.h"
#include "sde_hw_rot.h"
#include "sde_hw_sspp.h"
/**
* struct sde_plane_rot_state - state of pre-sspp rotator stage
* @sequence_id: sequence identifier, incremented per state duplication
* @rot_hw: Pointer to rotator hardware driver
* @rot90: true if rotation of 90 degree is required
* @hflip: true if horizontal flip is required
* @vflip: true if vertical flip is required
* @rot_cmd: rotator configuration command
* @nplane: total number of drm plane attached to rotator
* @in_fb: input fb attached to rotator
* @in_rotation: input rotation property of rotator stage
* @in_rot_rect: input rectangle of the rotator in plane fb coordinate
* @out_rotation: output rotation property of rotator stage
* @out_rot_rect: output rectangle of the rotator in plane fb coordinate
* @out_src_rect: output rectangle of the plane source in plane fb coordinate
* @out_src_x: output src_x of rotator stage in rotator output fb coordinate
* @out_src_y: output src y of rotator stage in rotator output fb coordinate
* @out_src_w: output src w of rotator stage in rotator output fb ooordinate
* @out_src_h: output src h of rotator stage in rotator output fb coordinate
* @out_fb_width: output framebuffer width of rotator stage
* @out_fb_height: output framebuffer height of rotator stage
* @out_fb_pixel_format: output framebuffer pixel format of rotator stage
* @out_fb_modifier: output framebuffer modifier of rotator stage
* @out_fb_flags: output framebuffer flags of rotator stage
* @out_sbuf: true if output streaming buffer is required
* @out_fb_format: Pointer to output framebuffer format of rotator stage
* @out_fb: Pointer to output drm framebuffer of rotator stage
* @out_fbo: framebuffer object of output streaming buffer
* @out_xpos: relative horizontal position of the plane (0 - leftmost)
*/
struct sde_plane_rot_state {
u32 sequence_id;
struct sde_hw_rot *rot_hw;
bool rot90;
bool hflip;
bool vflip;
struct sde_hw_rot_cmd rot_cmd;
int nplane;
/* input */
struct drm_framebuffer *in_fb;
struct drm_rect in_rot_rect;
u32 in_rotation;
/* output */
struct drm_rect out_rot_rect;
struct drm_rect out_src_rect;
u32 out_rotation;
u32 out_src_x;
u32 out_src_y;
u32 out_src_w;
u32 out_src_h;
u32 out_fb_width;
u32 out_fb_height;
u32 out_fb_pixel_format;
u64 out_fb_modifier[4];
u32 out_fb_flags;
bool out_sbuf;
const struct sde_format *out_fb_format;
struct drm_framebuffer *out_fb;
struct sde_kms_fbo *out_fbo;
int out_xpos;
};
/* dirty bits for update function */
#define SDE_PLANE_DIRTY_RECTS 0x1
#define SDE_PLANE_DIRTY_FORMAT 0x2
#define SDE_PLANE_DIRTY_SHARPEN 0x4
#define SDE_PLANE_DIRTY_PERF 0x8
#define SDE_PLANE_DIRTY_FB_TRANSLATION_MODE 0x10
#define SDE_PLANE_DIRTY_ALL 0xFFFFFFFF
/**
* enum sde_plane_sclcheck_state - User scaler data status
*
* @SDE_PLANE_SCLCHECK_NONE: No user data provided
* @SDE_PLANE_SCLCHECK_INVALID: Invalid user data provided
* @SDE_PLANE_SCLCHECK_SCALER_V1: Valid scaler v1 data
* @SDE_PLANE_SCLCHECK_SCALER_V1_CHECK: Unchecked scaler v1 data
* @SDE_PLANE_SCLCHECK_SCALER_V2: Valid scaler v2 data
* @SDE_PLANE_SCLCHECK_SCALER_V2_CHECK: Unchecked scaler v2 data
*/
enum sde_plane_sclcheck_state {
SDE_PLANE_SCLCHECK_NONE,
SDE_PLANE_SCLCHECK_INVALID,
SDE_PLANE_SCLCHECK_SCALER_V1,
SDE_PLANE_SCLCHECK_SCALER_V1_CHECK,
SDE_PLANE_SCLCHECK_SCALER_V2,
SDE_PLANE_SCLCHECK_SCALER_V2_CHECK,
};
/**
* struct sde_plane_state: Define sde extension of drm plane state object
* @base: base drm plane state object
* @property_state: Local storage for msm_prop properties
* @property_values: cached plane property values
* @aspace: pointer to address space for input/output buffers
* @input_fence: dereferenced input fence pointer
* @stage: assigned by crtc blender
* @excl_rect: exclusion rect values
* @dirty: bitmask for which pipe h/w config functions need to be updated
* @multirect_index: index of the rectangle of SSPP
* @multirect_mode: parallel or time multiplex multirect mode
* @pending: whether the current update is still pending
* @defer_prepare_fb: indicate if prepare_fb call was deferred
* @scaler3_cfg: configuration data for scaler3
* @pixel_ext: configuration data for pixel extensions
* @scaler_check_state: indicates status of user provided pixel extension data
* @cdp_cfg: CDP configuration
*/
struct sde_plane_state {
struct drm_plane_state base;
struct msm_property_state property_state;
struct msm_property_value property_values[PLANE_PROP_COUNT];
struct msm_gem_address_space *aspace;
void *input_fence;
enum sde_stage stage;
struct sde_rect excl_rect;
uint32_t dirty;
uint32_t multirect_index;
uint32_t multirect_mode;
bool pending;
bool defer_prepare_fb;
/* scaler configuration */
struct sde_hw_scaler3_cfg scaler3_cfg;
struct sde_hw_pixel_ext pixel_ext;
enum sde_plane_sclcheck_state scaler_check_state;
/* @sc_cfg: system_cache configuration */
struct sde_hw_pipe_sc_cfg sc_cfg;
struct sde_plane_rot_state rot;
struct sde_hw_pipe_cdp_cfg cdp_cfg;
};
/**
* struct sde_multirect_plane_states: Defines multirect pair of drm plane states
* @r0: drm plane configured on rect 0
* @r1: drm plane configured on rect 1
*/
struct sde_multirect_plane_states {
const struct drm_plane_state *r0;
const struct drm_plane_state *r1;
};
#define to_sde_plane_state(x) \
container_of(x, struct sde_plane_state, base)
/**
* sde_plane_get_property - Query integer value of plane property
* @S: Pointer to plane state
* @X: Property index, from enum msm_mdp_plane_property
* Returns: Integer value of requested property
*/
#define sde_plane_get_property(S, X) ((S) && ((X) < PLANE_PROP_COUNT) ? \
((S)->property_values[(X)].value) : 0)
/**
* sde_plane_pipe - return sspp identifier for the given plane
* @plane: Pointer to DRM plane object
* Returns: sspp identifier of the given plane
*/
enum sde_sspp sde_plane_pipe(struct drm_plane *plane);
/**
* is_sde_plane_virtual - check for virtual plane
* @plane: Pointer to DRM plane object
* returns: true - if the plane is virtual
* false - if the plane is primary
*/
bool is_sde_plane_virtual(struct drm_plane *plane);
/**
* sde_plane_get_ctl_flush - get control flush mask
* @plane: Pointer to DRM plane object
* @ctl: Pointer to control hardware
* @flush_sspp: Pointer to sspp flush control word
* @flush_rot: Pointer to rotator flush control word
*/
void sde_plane_get_ctl_flush(struct drm_plane *plane, struct sde_hw_ctl *ctl,
u32 *flush_sspp, u32 *flush_rot);
/**
* sde_plane_rot_calc_prefill - calculate rotator start prefill
* @plane: Pointer to drm plane
* return: prefill time in line
*/
u32 sde_plane_rot_calc_prefill(struct drm_plane *plane);
/**
* sde_plane_restore - restore hw state if previously power collapsed
* @plane: Pointer to drm plane structure
*/
void sde_plane_restore(struct drm_plane *plane);
/**
* sde_plane_flush - final plane operations before commit flush
* @plane: Pointer to drm plane structure
*/
void sde_plane_flush(struct drm_plane *plane);
/**
* sde_plane_kickoff_rot - final plane rotator operations before commit kickoff
* @plane: Pointer to drm plane structure
* Returns: Zero on success
*/
int sde_plane_kickoff_rot(struct drm_plane *plane);
/**
* sde_plane_set_error: enable/disable error condition
* @plane: pointer to drm_plane structure
*/
void sde_plane_set_error(struct drm_plane *plane, bool error);
/**
* sde_plane_init - create new sde plane for the given pipe
* @dev: Pointer to DRM device
* @pipe: sde hardware pipe identifier
* @primary_plane: true if this pipe is primary plane for crtc
* @possible_crtcs: bitmask of crtc that can be attached to the given pipe
* @master_plane_id: primary plane id of a multirect pipe. 0 value passed for
* a regular plane initialization. A non-zero primary plane
* id will be passed for a virtual pipe initialization.
*
*/
struct drm_plane *sde_plane_init(struct drm_device *dev,
uint32_t pipe, bool primary_plane,
unsigned long possible_crtcs, u32 master_plane_id);
/**
* sde_plane_validate_multirecti_v2 - validate the multirect planes
* against hw limitations
* @plane: drm plate states of the multirect pair
*/
int sde_plane_validate_multirect_v2(struct sde_multirect_plane_states *plane);
/**
* sde_plane_clear_multirect - clear multirect bits for the given pipe
* @drm_state: Pointer to DRM plane state
*/
void sde_plane_clear_multirect(const struct drm_plane_state *drm_state);
/**
* sde_plane_wait_input_fence - wait for input fence object
* @plane: Pointer to DRM plane object
* @wait_ms: Wait timeout value
* Returns: Zero on success
*/
int sde_plane_wait_input_fence(struct drm_plane *plane, uint32_t wait_ms);
/**
* sde_plane_color_fill - enables color fill on plane
* @plane: Pointer to DRM plane object
* @color: RGB fill color value, [23..16] Blue, [15..8] Green, [7..0] Red
* @alpha: 8-bit fill alpha value, 255 selects 100% alpha
* Returns: 0 on success
*/
int sde_plane_color_fill(struct drm_plane *plane,
uint32_t color, uint32_t alpha);
/**
* sde_plane_set_revalidate - sets revalidate flag which forces a full
* validation of the plane properties in the next atomic check
* @plane: Pointer to DRM plane object
* @enable: Boolean to set/unset the flag
*/
void sde_plane_set_revalidate(struct drm_plane *plane, bool enable);
/**
* sde_plane_helper_reset_properties - reset properties to default values in the
* given DRM plane state object
* @plane: Pointer to DRM plane object
* @plane_state: Pointer to DRM plane state object
* Returns: 0 on success, negative errno on failure
*/
int sde_plane_helper_reset_custom_properties(struct drm_plane *plane,
struct drm_plane_state *plane_state);
#endif /* _SDE_PLANE_H_ */