| /* SPDX-License-Identifier: GPL-2.0-only WITH Linux-syscall-note */ |
| /* |
| * Copyright (c) 2017-2018, 2020, The Linux Foundation. All rights reserved. |
| */ |
| |
| #ifndef _SDE_DRM_H_ |
| #define _SDE_DRM_H_ |
| |
| #include "drm.h" |
| |
| /* Total number of supported color planes */ |
| #define SDE_MAX_PLANES 4 |
| |
| /* Total number of parameterized detail enhancer mapping curves */ |
| #define SDE_MAX_DE_CURVES 3 |
| |
| /* Y/RGB and UV filter configuration */ |
| #define FILTER_EDGE_DIRECTED_2D 0x0 |
| #define FILTER_CIRCULAR_2D 0x1 |
| #define FILTER_SEPARABLE_1D 0x2 |
| #define FILTER_BILINEAR 0x3 |
| |
| /* Alpha filters */ |
| #define FILTER_ALPHA_DROP_REPEAT 0x0 |
| #define FILTER_ALPHA_BILINEAR 0x1 |
| #define FILTER_ALPHA_2D 0x3 |
| |
| /* Blend filters */ |
| #define FILTER_BLEND_CIRCULAR_2D 0x0 |
| #define FILTER_BLEND_SEPARABLE_1D 0x1 |
| |
| /* LUT configuration flags */ |
| #define SCALER_LUT_SWAP 0x1 |
| #define SCALER_LUT_DIR_WR 0x2 |
| #define SCALER_LUT_Y_CIR_WR 0x4 |
| #define SCALER_LUT_UV_CIR_WR 0x8 |
| #define SCALER_LUT_Y_SEP_WR 0x10 |
| #define SCALER_LUT_UV_SEP_WR 0x20 |
| |
| /** |
| * Blend operations for "blend_op" property |
| * |
| * @SDE_DRM_BLEND_OP_NOT_DEFINED: No blend operation defined for the layer. |
| * @SDE_DRM_BLEND_OP_OPAQUE: Apply a constant blend operation. The layer |
| * would appear opaque in case fg plane alpha |
| * is 0xff. |
| * @SDE_DRM_BLEND_OP_PREMULTIPLIED: Apply source over blend rule. Layer already |
| * has alpha pre-multiplication done. If the fg |
| * plane alpha is less than 0xff, apply |
| * modulation as well. This operation is |
| * intended on layers having alpha channel. |
| * @SDE_DRM_BLEND_OP_COVERAGE: Apply source over blend rule. Layer is not |
| * alpha pre-multiplied. Apply |
| * pre-multiplication. If fg plane alpha is |
| * less than 0xff, apply modulation as well. |
| * @SDE_DRM_BLEND_OP_MAX: Used to track maximum blend operation |
| * possible by mdp. |
| */ |
| #define SDE_DRM_BLEND_OP_NOT_DEFINED 0 |
| #define SDE_DRM_BLEND_OP_OPAQUE 1 |
| #define SDE_DRM_BLEND_OP_PREMULTIPLIED 2 |
| #define SDE_DRM_BLEND_OP_COVERAGE 3 |
| #define SDE_DRM_BLEND_OP_MAX 4 |
| |
| /** |
| * Bit masks for "src_config" property |
| * construct bitmask via (1UL << SDE_DRM_<flag>) |
| */ |
| #define SDE_DRM_DEINTERLACE 0 /* Specifies interlaced input */ |
| |
| /* DRM bitmasks are restricted to 0..63 */ |
| #define SDE_DRM_BITMASK_COUNT 64 |
| |
| /** |
| * Framebuffer modes for "fb_translation_mode" PLANE and CONNECTOR property |
| * |
| * @SDE_DRM_FB_NON_SEC: IOMMU configuration for this framebuffer mode |
| * is non-secure domain and requires |
| * both stage I and stage II translations when |
| * this buffer is accessed by the display HW. |
| * This is the default mode of all frambuffers. |
| * @SDE_DRM_FB_SEC: IOMMU configuration for this framebuffer mode |
| * is secure domain and requires |
| * both stage I and stage II translations when |
| * this buffer is accessed by the display HW. |
| * @SDE_DRM_FB_NON_SEC_DIR_TRANS: IOMMU configuration for this framebuffer mode |
| * is non-secure domain and requires |
| * only stage II translation when |
| * this buffer is accessed by the display HW. |
| * @SDE_DRM_FB_SEC_DIR_TRANS: IOMMU configuration for this framebuffer mode |
| * is secure domain and requires |
| * only stage II translation when |
| * this buffer is accessed by the display HW. |
| */ |
| |
| #define SDE_DRM_FB_NON_SEC 0 |
| #define SDE_DRM_FB_SEC 1 |
| #define SDE_DRM_FB_NON_SEC_DIR_TRANS 2 |
| #define SDE_DRM_FB_SEC_DIR_TRANS 3 |
| |
| /** |
| * Secure levels for "security_level" CRTC property. |
| * CRTC property which specifies what plane types |
| * can be attached to this CRTC. Plane component |
| * derives the plane type based on the FB_MODE. |
| * @ SDE_DRM_SEC_NON_SEC: Both Secure and non-secure plane types can be |
| * attached to this CRTC. This is the default state of |
| * the CRTC. |
| * @ SDE_DRM_SEC_ONLY: Only secure planes can be added to this CRTC. If a |
| * CRTC is instructed to be in this mode it follows the |
| * platform dependent restrictions. |
| */ |
| #define SDE_DRM_SEC_NON_SEC 0 |
| #define SDE_DRM_SEC_ONLY 1 |
| |
| /** |
| * struct sde_drm_pix_ext_v1 - version 1 of pixel ext structure |
| * @num_ext_pxls_lr: Number of total horizontal pixels |
| * @num_ext_pxls_tb: Number of total vertical lines |
| * @left_ftch: Number of extra pixels to overfetch from left |
| * @right_ftch: Number of extra pixels to overfetch from right |
| * @top_ftch: Number of extra lines to overfetch from top |
| * @btm_ftch: Number of extra lines to overfetch from bottom |
| * @left_rpt: Number of extra pixels to repeat from left |
| * @right_rpt: Number of extra pixels to repeat from right |
| * @top_rpt: Number of extra lines to repeat from top |
| * @btm_rpt: Number of extra lines to repeat from bottom |
| */ |
| struct sde_drm_pix_ext_v1 { |
| /* |
| * Number of pixels ext in left, right, top and bottom direction |
| * for all color components. |
| */ |
| int32_t num_ext_pxls_lr[SDE_MAX_PLANES]; |
| int32_t num_ext_pxls_tb[SDE_MAX_PLANES]; |
| |
| /* |
| * Number of pixels needs to be overfetched in left, right, top |
| * and bottom directions from source image for scaling. |
| */ |
| int32_t left_ftch[SDE_MAX_PLANES]; |
| int32_t right_ftch[SDE_MAX_PLANES]; |
| int32_t top_ftch[SDE_MAX_PLANES]; |
| int32_t btm_ftch[SDE_MAX_PLANES]; |
| /* |
| * Number of pixels needs to be repeated in left, right, top and |
| * bottom directions for scaling. |
| */ |
| int32_t left_rpt[SDE_MAX_PLANES]; |
| int32_t right_rpt[SDE_MAX_PLANES]; |
| int32_t top_rpt[SDE_MAX_PLANES]; |
| int32_t btm_rpt[SDE_MAX_PLANES]; |
| |
| }; |
| |
| /** |
| * struct sde_drm_scaler_v1 - version 1 of struct sde_drm_scaler |
| * @lr: Pixel extension settings for left/right |
| * @tb: Pixel extension settings for top/botton |
| * @init_phase_x: Initial scaler phase values for x |
| * @phase_step_x: Phase step values for x |
| * @init_phase_y: Initial scaler phase values for y |
| * @phase_step_y: Phase step values for y |
| * @horz_filter: Horizontal filter array |
| * @vert_filter: Vertical filter array |
| */ |
| struct sde_drm_scaler_v1 { |
| /* |
| * Pix ext settings |
| */ |
| struct sde_drm_pix_ext_v1 pe; |
| /* |
| * Phase settings |
| */ |
| int32_t init_phase_x[SDE_MAX_PLANES]; |
| int32_t phase_step_x[SDE_MAX_PLANES]; |
| int32_t init_phase_y[SDE_MAX_PLANES]; |
| int32_t phase_step_y[SDE_MAX_PLANES]; |
| |
| /* |
| * Filter type to be used for scaling in horizontal and vertical |
| * directions |
| */ |
| uint32_t horz_filter[SDE_MAX_PLANES]; |
| uint32_t vert_filter[SDE_MAX_PLANES]; |
| }; |
| |
| /** |
| * struct sde_drm_de_v1 - version 1 of detail enhancer structure |
| * @enable: Enables/disables detail enhancer |
| * @sharpen_level1: Sharpening strength for noise |
| * @sharpen_level2: Sharpening strength for context |
| * @clip: Clip coefficient |
| * @limit: Detail enhancer limit factor |
| * @thr_quiet: Quite zone threshold |
| * @thr_dieout: Die-out zone threshold |
| * @thr_low: Linear zone left threshold |
| * @thr_high: Linear zone right threshold |
| * @prec_shift: Detail enhancer precision |
| * @adjust_a: Mapping curves A coefficients |
| * @adjust_b: Mapping curves B coefficients |
| * @adjust_c: Mapping curves C coefficients |
| */ |
| struct sde_drm_de_v1 { |
| uint32_t enable; |
| int16_t sharpen_level1; |
| int16_t sharpen_level2; |
| uint16_t clip; |
| uint16_t limit; |
| uint16_t thr_quiet; |
| uint16_t thr_dieout; |
| uint16_t thr_low; |
| uint16_t thr_high; |
| uint16_t prec_shift; |
| int16_t adjust_a[SDE_MAX_DE_CURVES]; |
| int16_t adjust_b[SDE_MAX_DE_CURVES]; |
| int16_t adjust_c[SDE_MAX_DE_CURVES]; |
| }; |
| |
| /* |
| * Scaler configuration flags |
| */ |
| |
| /* Disable dynamic expansion */ |
| #define SDE_DYN_EXP_DISABLE 0x1 |
| |
| #define SDE_DRM_QSEED3LITE |
| #define SDE_DRM_QSEED4 |
| #define SDE_DRM_INLINE_PREDOWNSCALE |
| |
| /** |
| * struct sde_drm_scaler_v2 - version 2 of struct sde_drm_scaler |
| * @enable: Scaler enable |
| * @dir_en: Detail enhancer enable |
| * @pe: Pixel extension settings |
| * @horz_decimate: Horizontal decimation factor |
| * @vert_decimate: Vertical decimation factor |
| * @init_phase_x: Initial scaler phase values for x |
| * @phase_step_x: Phase step values for x |
| * @init_phase_y: Initial scaler phase values for y |
| * @phase_step_y: Phase step values for y |
| * @preload_x: Horizontal preload value |
| * @preload_y: Vertical preload value |
| * @src_width: Source width |
| * @src_height: Source height |
| * @dst_width: Destination width |
| * @dst_height: Destination height |
| * @y_rgb_filter_cfg: Y/RGB plane filter configuration |
| * @uv_filter_cfg: UV plane filter configuration |
| * @alpha_filter_cfg: Alpha filter configuration |
| * @blend_cfg: Selection of blend coefficients |
| * @lut_flag: LUT configuration flags |
| * @dir_lut_idx: 2d 4x4 LUT index |
| * @y_rgb_cir_lut_idx: Y/RGB circular LUT index |
| * @uv_cir_lut_idx: UV circular LUT index |
| * @y_rgb_sep_lut_idx: Y/RGB separable LUT index |
| * @uv_sep_lut_idx: UV separable LUT index |
| * @de: Detail enhancer settings |
| * @dir_weight: Directional Weight |
| * @unsharp_mask_blend: Unsharp Blend Filter Ratio |
| * @de_blend: Ratio of two unsharp mask filters |
| * @flags: Scaler configuration flags |
| * @pre_downscale_x_0 Pre-downscale ratio, x-direction, plane 0(Y/RGB) |
| * @pre_downscale_x_1 Pre-downscale ratio, x-direction, plane 1(UV) |
| * @pre_downscale_y_0 Pre-downscale ratio, y-direction, plane 0(Y/RGB) |
| * @pre_downscale_y_1 Pre-downscale ratio, y-direction, plane 1(UV) |
| */ |
| struct sde_drm_scaler_v2 { |
| /* |
| * General definitions |
| */ |
| uint32_t enable; |
| uint32_t dir_en; |
| |
| /* |
| * Pix ext settings |
| */ |
| struct sde_drm_pix_ext_v1 pe; |
| |
| /* |
| * Decimation settings |
| */ |
| uint32_t horz_decimate; |
| uint32_t vert_decimate; |
| |
| /* |
| * Phase settings |
| */ |
| int32_t init_phase_x[SDE_MAX_PLANES]; |
| int32_t phase_step_x[SDE_MAX_PLANES]; |
| int32_t init_phase_y[SDE_MAX_PLANES]; |
| int32_t phase_step_y[SDE_MAX_PLANES]; |
| |
| uint32_t preload_x[SDE_MAX_PLANES]; |
| uint32_t preload_y[SDE_MAX_PLANES]; |
| uint32_t src_width[SDE_MAX_PLANES]; |
| uint32_t src_height[SDE_MAX_PLANES]; |
| |
| uint32_t dst_width; |
| uint32_t dst_height; |
| |
| uint32_t y_rgb_filter_cfg; |
| uint32_t uv_filter_cfg; |
| uint32_t alpha_filter_cfg; |
| uint32_t blend_cfg; |
| |
| uint32_t lut_flag; |
| uint32_t dir_lut_idx; |
| |
| /* for Y(RGB) and UV planes*/ |
| uint32_t y_rgb_cir_lut_idx; |
| uint32_t uv_cir_lut_idx; |
| uint32_t y_rgb_sep_lut_idx; |
| uint32_t uv_sep_lut_idx; |
| |
| /* |
| * Detail enhancer settings |
| */ |
| struct sde_drm_de_v1 de; |
| uint32_t dir_weight; |
| uint32_t unsharp_mask_blend; |
| uint32_t de_blend; |
| uint32_t flags; |
| |
| /* |
| * Inline pre-downscale settings |
| */ |
| uint32_t pre_downscale_x_0; |
| uint32_t pre_downscale_x_1; |
| uint32_t pre_downscale_y_0; |
| uint32_t pre_downscale_y_1; |
| }; |
| |
| /* Number of dest scalers supported */ |
| #define SDE_MAX_DS_COUNT 2 |
| |
| /* |
| * Destination scaler flag config |
| */ |
| #define SDE_DRM_DESTSCALER_ENABLE 0x1 |
| #define SDE_DRM_DESTSCALER_SCALE_UPDATE 0x2 |
| #define SDE_DRM_DESTSCALER_ENHANCER_UPDATE 0x4 |
| #define SDE_DRM_DESTSCALER_PU_ENABLE 0x8 |
| |
| /** |
| * struct sde_drm_dest_scaler_cfg - destination scaler config structure |
| * @flags: Flag to switch between mode for destination scaler |
| * refer to destination scaler flag config |
| * @index: Destination scaler selection index |
| * @lm_width: Layer mixer width configuration |
| * @lm_height: Layer mixer height configuration |
| * @scaler_cfg: The scaling parameters for all the mode except disable |
| * Userspace pointer to struct sde_drm_scaler_v2 |
| */ |
| struct sde_drm_dest_scaler_cfg { |
| uint32_t flags; |
| uint32_t index; |
| uint32_t lm_width; |
| uint32_t lm_height; |
| uint64_t scaler_cfg; |
| }; |
| |
| /** |
| * struct sde_drm_dest_scaler_data - destination scaler data struct |
| * @num_dest_scaler: Number of dest scalers to be configured |
| * @ds_cfg: Destination scaler block configuration |
| */ |
| struct sde_drm_dest_scaler_data { |
| uint32_t num_dest_scaler; |
| struct sde_drm_dest_scaler_cfg ds_cfg[SDE_MAX_DS_COUNT]; |
| }; |
| |
| /* |
| * Define constants for struct sde_drm_csc |
| */ |
| #define SDE_CSC_MATRIX_COEFF_SIZE 9 |
| #define SDE_CSC_CLAMP_SIZE 6 |
| #define SDE_CSC_BIAS_SIZE 3 |
| |
| /** |
| * struct sde_drm_csc_v1 - version 1 of struct sde_drm_csc |
| * @ctm_coeff: Matrix coefficients, in S31.32 format |
| * @pre_bias: Pre-bias array values |
| * @post_bias: Post-bias array values |
| * @pre_clamp: Pre-clamp array values |
| * @post_clamp: Post-clamp array values |
| */ |
| struct sde_drm_csc_v1 { |
| int64_t ctm_coeff[SDE_CSC_MATRIX_COEFF_SIZE]; |
| uint32_t pre_bias[SDE_CSC_BIAS_SIZE]; |
| uint32_t post_bias[SDE_CSC_BIAS_SIZE]; |
| uint32_t pre_clamp[SDE_CSC_CLAMP_SIZE]; |
| uint32_t post_clamp[SDE_CSC_CLAMP_SIZE]; |
| }; |
| |
| /** |
| * struct sde_drm_color - struct to store the color and alpha values |
| * @color_0: Color 0 value |
| * @color_1: Color 1 value |
| * @color_2: Color 2 value |
| * @color_3: Color 3 value |
| */ |
| struct sde_drm_color { |
| uint32_t color_0; |
| uint32_t color_1; |
| uint32_t color_2; |
| uint32_t color_3; |
| }; |
| |
| /* Total number of supported dim layers */ |
| #define SDE_MAX_DIM_LAYERS 7 |
| |
| /* SDE_DRM_DIM_LAYER_CONFIG_FLAG - flags for Dim Layer */ |
| /* Color fill inside of the rect, including border */ |
| #define SDE_DRM_DIM_LAYER_INCLUSIVE 0x1 |
| /* Color fill outside of the rect, excluding border */ |
| #define SDE_DRM_DIM_LAYER_EXCLUSIVE 0x2 |
| |
| /** |
| * struct sde_drm_dim_layer - dim layer cfg struct |
| * @flags: Refer SDE_DRM_DIM_LAYER_CONFIG_FLAG for possible values |
| * @stage: Blending stage of the dim layer |
| * @color_fill: Color fill for dim layer |
| * @rect: Dim layer coordinates |
| */ |
| struct sde_drm_dim_layer_cfg { |
| uint32_t flags; |
| uint32_t stage; |
| struct sde_drm_color color_fill; |
| struct drm_clip_rect rect; |
| }; |
| |
| /** |
| * struct sde_drm_dim_layer_v1 - version 1 of dim layer struct |
| * @num_layers: Numer of Dim Layers |
| * @layer: Dim layer user cfgs ptr for the num_layers |
| */ |
| struct sde_drm_dim_layer_v1 { |
| uint32_t num_layers; |
| struct sde_drm_dim_layer_cfg layer_cfg[SDE_MAX_DIM_LAYERS]; |
| }; |
| |
| /* Writeback Config version definition */ |
| #define SDE_DRM_WB_CFG 0x1 |
| |
| /* SDE_DRM_WB_CONFIG_FLAGS - Writeback configuration flags */ |
| #define SDE_DRM_WB_CFG_FLAGS_CONNECTED (1<<0) |
| |
| /** |
| * struct sde_drm_wb_cfg - Writeback configuration structure |
| * @flags: see DRM_MSM_WB_CONFIG_FLAGS |
| * @connector_id: writeback connector identifier |
| * @count_modes: Count of modes in modes_ptr |
| * @modes: Pointer to struct drm_mode_modeinfo |
| */ |
| struct sde_drm_wb_cfg { |
| uint32_t flags; |
| uint32_t connector_id; |
| uint32_t count_modes; |
| uint64_t modes; |
| }; |
| |
| #define SDE_MAX_ROI_V1 4 |
| |
| /** |
| * struct sde_drm_roi_v1 - list of regions of interest for a drm object |
| * @num_rects: number of valid rectangles in the roi array |
| * @roi: list of roi rectangles |
| */ |
| struct sde_drm_roi_v1 { |
| uint32_t num_rects; |
| struct drm_clip_rect roi[SDE_MAX_ROI_V1]; |
| }; |
| |
| /** |
| * Define extended power modes supported by the SDE connectors. |
| */ |
| #define SDE_MODE_DPMS_ON 0 |
| #define SDE_MODE_DPMS_LP1 1 |
| #define SDE_MODE_DPMS_LP2 2 |
| #define SDE_MODE_DPMS_STANDBY 3 |
| #define SDE_MODE_DPMS_SUSPEND 4 |
| #define SDE_MODE_DPMS_OFF 5 |
| |
| /** |
| * sde recovery events for notifying client |
| */ |
| #define SDE_RECOVERY_SUCCESS 0 |
| #define SDE_RECOVERY_CAPTURE 1 |
| #define SDE_RECOVERY_HARD_RESET 2 |
| |
| #endif /* _SDE_DRM_H_ */ |
