root/drivers/gpu/drm/msm/disp/dpu1/dpu_hw_sspp.h
/* SPDX-License-Identifier: GPL-2.0-only */
/* Copyright (c) 2015-2018, The Linux Foundation. All rights reserved.
 */

#ifndef _DPU_HW_SSPP_H
#define _DPU_HW_SSPP_H

#include "dpu_hw_catalog.h"
#include "dpu_hw_mdss.h"
#include "dpu_hw_util.h"
#include "dpu_formats.h"

struct dpu_hw_sspp;

#define DPU_SSPP_MAX_PITCH_SIZE         0xffff

/*
 * Flags
 */
#define DPU_SSPP_FLIP_LR                BIT(0)
#define DPU_SSPP_FLIP_UD                BIT(1)
#define DPU_SSPP_SOURCE_ROTATED_90      BIT(2)
#define DPU_SSPP_ROT_90                 BIT(3)
#define DPU_SSPP_SOLID_FILL             BIT(4)

/*
 * Component indices
 */
enum {
        DPU_SSPP_COMP_0,
        DPU_SSPP_COMP_1_2,
        DPU_SSPP_COMP_2,
        DPU_SSPP_COMP_3,

        DPU_SSPP_COMP_MAX
};

/**
 * enum dpu_sspp_multirect_index - multirect mode
 * @DPU_SSPP_RECT_SOLO: multirect disabled
 * @DPU_SSPP_RECT_0: rect0 of a multirect pipe
 * @DPU_SSPP_RECT_1: rect1 of a multirect pipe
 *
 * Note: HW supports multirect with either RECT0 or
 * RECT1. Considering no benefit of such configs over
 * SOLO mode and to keep the plane management simple,
 * we dont support single rect multirect configs.
 */
enum dpu_sspp_multirect_index {
        DPU_SSPP_RECT_SOLO = 0,
        DPU_SSPP_RECT_0,
        DPU_SSPP_RECT_1,
};

enum dpu_sspp_multirect_mode {
        DPU_SSPP_MULTIRECT_NONE = 0,
        DPU_SSPP_MULTIRECT_PARALLEL,
        DPU_SSPP_MULTIRECT_TIME_MX,
};

enum {
        DPU_FRAME_LINEAR,
        DPU_FRAME_TILE_A4X,
        DPU_FRAME_TILE_A5X,
};

enum dpu_hw_filter {
        DPU_SCALE_FILTER_NEAREST = 0,
        DPU_SCALE_FILTER_BIL,
        DPU_SCALE_FILTER_PCMN,
        DPU_SCALE_FILTER_CA,
        DPU_SCALE_FILTER_MAX
};

enum dpu_hw_filter_alpa {
        DPU_SCALE_ALPHA_PIXEL_REP,
        DPU_SCALE_ALPHA_BIL
};

enum dpu_hw_filter_yuv {
        DPU_SCALE_2D_4X4,
        DPU_SCALE_2D_CIR,
        DPU_SCALE_1D_SEP,
        DPU_SCALE_BIL
};

struct dpu_hw_sharp_cfg {
        u32 strength;
        u32 edge_thr;
        u32 smooth_thr;
        u32 noise_thr;
};

struct dpu_hw_pixel_ext {
        /* scaling factors are enabled for this input layer */
        uint8_t enable_pxl_ext;

        int init_phase_x[DPU_MAX_PLANES];
        int phase_step_x[DPU_MAX_PLANES];
        int init_phase_y[DPU_MAX_PLANES];
        int phase_step_y[DPU_MAX_PLANES];

        /*
         * Number of pixels extension in left, right, top and bottom direction
         * for all color components. This pixel value for each color component
         * should be sum of fetch + repeat pixels.
         */
        int num_ext_pxls_left[DPU_MAX_PLANES];
        int num_ext_pxls_right[DPU_MAX_PLANES];
        int num_ext_pxls_top[DPU_MAX_PLANES];
        int num_ext_pxls_btm[DPU_MAX_PLANES];

        /*
         * Number of pixels needs to be overfetched in left, right, top and
         * bottom directions from source image for scaling.
         */
        int left_ftch[DPU_MAX_PLANES];
        int right_ftch[DPU_MAX_PLANES];
        int top_ftch[DPU_MAX_PLANES];
        int btm_ftch[DPU_MAX_PLANES];

        /*
         * Number of pixels needs to be repeated in left, right, top and
         * bottom directions for scaling.
         */
        int left_rpt[DPU_MAX_PLANES];
        int right_rpt[DPU_MAX_PLANES];
        int top_rpt[DPU_MAX_PLANES];
        int btm_rpt[DPU_MAX_PLANES];

        uint32_t roi_w[DPU_MAX_PLANES];
        uint32_t roi_h[DPU_MAX_PLANES];

        /*
         * Filter type to be used for scaling in horizontal and vertical
         * directions
         */
        enum dpu_hw_filter horz_filter[DPU_MAX_PLANES];
        enum dpu_hw_filter vert_filter[DPU_MAX_PLANES];

};

/**
 * struct dpu_sw_pipe_cfg : software pipe configuration
 * @src_rect:  src ROI, caller takes into account the different operations
 *             such as decimation, flip etc to program this field
 * @dst_rect: destination ROI.
 * @rotation: simplified drm rotation hint
 */
struct dpu_sw_pipe_cfg {
        struct drm_rect src_rect;
        struct drm_rect dst_rect;
        unsigned int rotation;
};

/**
 * struct dpu_hw_pipe_ts_cfg - traffic shaper configuration
 * @size: size to prefill in bytes, or zero to disable
 * @time: time to prefill in usec, or zero to disable
 */
struct dpu_hw_pipe_ts_cfg {
        u64 size;
        u64 time;
};

/**
 * struct dpu_sw_pipe - software pipe description
 * @sspp:      backing SSPP pipe
 * @multirect_index:     index of the rectangle of SSPP
 * @multirect_mode:      parallel or time multiplex multirect mode
 */
struct dpu_sw_pipe {
        struct dpu_hw_sspp *sspp;
        enum dpu_sspp_multirect_index multirect_index;
        enum dpu_sspp_multirect_mode multirect_mode;
};

/**
 * struct dpu_hw_sspp_ops - interface to the SSPP Hw driver functions
 * Caller must call the init function to get the pipe context for each pipe
 * Assumption is these functions will be called after clocks are enabled
 */
struct dpu_hw_sspp_ops {
        /**
         * @setup_format: setup pixel format cropping rectangle, flip
         * @pipe: Pointer to software pipe context
         * @cfg: Pointer to pipe config structure
         * @flags: Extra flags for format config
         */
        void (*setup_format)(struct dpu_sw_pipe *pipe,
                             const struct msm_format *fmt, u32 flags);

        /**
         * @setup_rects: setup pipe ROI rectangles
         * @pipe: Pointer to software pipe context
         * @cfg: Pointer to pipe config structure
         */
        void (*setup_rects)(struct dpu_sw_pipe *pipe,
                            struct dpu_sw_pipe_cfg *cfg);

        /**
         * @setup_pe: setup pipe pixel extension
         * @ctx: Pointer to pipe context
         * @pe_ext: Pointer to pixel ext settings
         */
        void (*setup_pe)(struct dpu_hw_sspp *ctx,
                        struct dpu_hw_pixel_ext *pe_ext);

        /**
         * @setup_sourceaddress: setup pipe source addresses
         * @pipe: Pointer to software pipe context
         * @layout: format layout information for programming buffer to hardware
         */
        void (*setup_sourceaddress)(struct dpu_sw_pipe *ctx,
                                    struct dpu_hw_fmt_layout *layout);

        /**
         * @setup_csc: setup color space coversion
         * @ctx: Pointer to pipe context
         * @data: Pointer to config structure
         */
        void (*setup_csc)(struct dpu_hw_sspp *ctx, const struct dpu_csc_cfg *data);

        /**
         * @setup_solidfill: enable/disable colorfill
         * @pipe: Pointer to software pipe context
         * @const_color: Fill color value
         * @flags: Pipe flags
         */
        void (*setup_solidfill)(struct dpu_sw_pipe *pipe, u32 color);

        /**
         * @setup_multirect: setup multirect configuration
         * @pipe: Pointer to software pipe context
         */

        void (*setup_multirect)(struct dpu_sw_pipe *pipe);

        /**
         * @setup_sharpening: setup sharpening
         * @ctx: Pointer to pipe context
         * @cfg: Pointer to config structure
         */
        void (*setup_sharpening)(struct dpu_hw_sspp *ctx,
                        struct dpu_hw_sharp_cfg *cfg);

        /**
         * @setup_qos_lut: setup QoS LUTs
         * @ctx: Pointer to pipe context
         * @cfg: LUT configuration
         */
        void (*setup_qos_lut)(struct dpu_hw_sspp *ctx,
                        struct dpu_hw_qos_cfg *cfg);

        /**
         * @setup_qos_ctrl: setup QoS control
         * @ctx: Pointer to pipe context
         * @danger_safe_en: flags controlling enabling of danger/safe QoS/LUT
         */
        void (*setup_qos_ctrl)(struct dpu_hw_sspp *ctx,
                               bool danger_safe_en);

        /**
         * @setup_clk_force_ctrl: setup clock force control
         * @ctx: Pointer to pipe context
         * @enable: enable clock force if true
         */
        bool (*setup_clk_force_ctrl)(struct dpu_hw_sspp *ctx,
                                     bool enable);

        /**
         * @setup_histogram: setup histograms
         * @ctx: Pointer to pipe context
         * @cfg: Pointer to histogram configuration
         */
        void (*setup_histogram)(struct dpu_hw_sspp *ctx,
                        void *cfg);

        /**
         * @setup_scaler: setup scaler
         * @scaler3_cfg: Pointer to scaler configuration
         * @format: pixel format parameters
         */
        void (*setup_scaler)(struct dpu_hw_sspp *ctx,
                struct dpu_hw_scaler3_cfg *scaler3_cfg,
                const struct msm_format *format);

        /**
         * @setup_cdp: setup client driven prefetch
         * @pipe: Pointer to software pipe context
         * @fmt: format used by the sw pipe
         * @enable: whether the CDP should be enabled for this pipe
         */
        void (*setup_cdp)(struct dpu_sw_pipe *pipe,
                          const struct msm_format *fmt,
                          bool enable);
};

/**
 * struct dpu_hw_sspp - pipe description
 * @base: hardware block base structure
 * @hw: block hardware details
 * @ubwc: UBWC configuration data
 * @idx: pipe index
 * @cap: pointer to layer_cfg
 * @mdss_ver: MDSS version info to use for feature checks
 * @ops: pointer to operations possible for this pipe
 */
struct dpu_hw_sspp {
        struct dpu_hw_blk base;
        struct dpu_hw_blk_reg_map hw;
        const struct qcom_ubwc_cfg_data *ubwc;

        /* Pipe */
        enum dpu_sspp idx;
        const struct dpu_sspp_cfg *cap;

        const struct dpu_mdss_version *mdss_ver;

        /* Ops */
        struct dpu_hw_sspp_ops ops;
};

struct dpu_kms;

struct dpu_hw_sspp *dpu_hw_sspp_init(struct drm_device *dev,
                                     const struct dpu_sspp_cfg *cfg,
                                     void __iomem *addr,
                                     const struct qcom_ubwc_cfg_data *mdss_data,
                                     const struct dpu_mdss_version *mdss_rev);

int _dpu_hw_sspp_init_debugfs(struct dpu_hw_sspp *hw_pipe, struct dpu_kms *kms,
                              struct dentry *entry);

void dpu_hw_sspp_setup_opmode(struct dpu_hw_sspp *ctx,
                              u32 mask, u8 en);

void dpu_hw_sspp_setup_csc10_opmode(struct dpu_hw_sspp *ctx,
                                    u32 mask, u8 en);

void dpu_hw_sspp_setup_scaler3(struct dpu_hw_sspp *ctx,
                               struct dpu_hw_scaler3_cfg *scaler3_cfg,
                               const struct msm_format *format);

void dpu_hw_sspp_setup_csc(struct dpu_hw_sspp *ctx,
                           const struct dpu_csc_cfg *data);

void dpu_hw_setup_multirect_impl(struct dpu_sw_pipe *pipe,
                                 struct dpu_hw_sspp *ctx,
                                 u32 op_mode_off);

void dpu_hw_setup_format_impl(struct dpu_sw_pipe *pipe, const struct msm_format *fmt,
                              u32 flags, struct dpu_hw_sspp *ctx,
                              u32 op_mode_off, u32 unpack_pat_off, u32 format_off,
                              u32 ubwc_ctrl_off, u32 ubwc_err_off);

static inline void dpu_hw_setup_rects_impl(struct dpu_sw_pipe *pipe, struct dpu_sw_pipe_cfg *cfg,
                                           struct dpu_hw_sspp *ctx, u32 src_size_off,
                                           u32 src_xy_off, u32 out_size_off, u32 out_xy_off)
{
        struct dpu_hw_blk_reg_map *c;
        u32 src_size, src_xy, dst_size, dst_xy;

        c = &ctx->hw;

        /* src and dest rect programming */
        src_xy = (cfg->src_rect.y1 << 16) | cfg->src_rect.x1;
        src_size = (drm_rect_height(&cfg->src_rect) << 16) |
                   drm_rect_width(&cfg->src_rect);
        dst_xy = (cfg->dst_rect.y1 << 16) | cfg->dst_rect.x1;
        dst_size = (drm_rect_height(&cfg->dst_rect) << 16) |
                drm_rect_width(&cfg->dst_rect);

        /* rectangle register programming */
        DPU_REG_WRITE(c, src_size_off, src_size);
        DPU_REG_WRITE(c, src_xy_off, src_xy);
        DPU_REG_WRITE(c, out_size_off, dst_size);
        DPU_REG_WRITE(c, out_xy_off, dst_xy);
}

void dpu_hw_setup_solidfill_impl(struct dpu_sw_pipe *pipe,
                                 u32 color, struct dpu_hw_sspp *ctx, u32 const_clr_off);

void dpu_hw_sspp_setup_qos_ctrl_impl(struct dpu_hw_sspp *ctx,
                                     bool danger_safe_en, u32 ctrl_off);

void dpu_hw_sspp_init_v13(struct dpu_hw_sspp *c,
                          unsigned long features,
                          const struct dpu_mdss_version *mdss_rev);

#endif /*_DPU_HW_SSPP_H */