1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* Copyright (c) 2015-2018, The Linux Foundation. All rights reserved. 3 */ 4 5 #ifndef _DPU_HW_PINGPONG_H 6 #define _DPU_HW_PINGPONG_H 7 8 #include "dpu_hw_catalog.h" 9 #include "dpu_hw_mdss.h" 10 #include "dpu_hw_util.h" 11 #include "dpu_hw_blk.h" 12 13 #define DITHER_MATRIX_SZ 16 14 15 struct dpu_hw_pingpong; 16 17 struct dpu_hw_tear_check { 18 /* 19 * This is ratio of MDP VSYNC clk freq(Hz) to 20 * refresh rate divided by no of lines 21 */ 22 u32 vsync_count; 23 u32 sync_cfg_height; 24 u32 vsync_init_val; 25 u32 sync_threshold_start; 26 u32 sync_threshold_continue; 27 u32 start_pos; 28 u32 rd_ptr_irq; 29 u8 hw_vsync_mode; 30 }; 31 32 struct dpu_hw_pp_vsync_info { 33 u32 rd_ptr_init_val; /* value of rd pointer at vsync edge */ 34 u32 rd_ptr_frame_count; /* num frames sent since enabling interface */ 35 u32 rd_ptr_line_count; /* current line on panel (rd ptr) */ 36 u32 wr_ptr_line_count; /* current line within pp fifo (wr ptr) */ 37 }; 38 39 /** 40 * struct dpu_hw_dither_cfg - dither feature structure 41 * @flags: for customizing operations 42 * @temporal_en: temperal dither enable 43 * @c0_bitdepth: c0 component bit depth 44 * @c1_bitdepth: c1 component bit depth 45 * @c2_bitdepth: c2 component bit depth 46 * @c3_bitdepth: c2 component bit depth 47 * @matrix: dither strength matrix 48 */ 49 struct dpu_hw_dither_cfg { 50 u64 flags; 51 u32 temporal_en; 52 u32 c0_bitdepth; 53 u32 c1_bitdepth; 54 u32 c2_bitdepth; 55 u32 c3_bitdepth; 56 u32 matrix[DITHER_MATRIX_SZ]; 57 }; 58 59 /** 60 * 61 * struct dpu_hw_pingpong_ops : Interface to the pingpong Hw driver functions 62 * Assumption is these functions will be called after clocks are enabled 63 * @setup_tearcheck : program tear check values 64 * @enable_tearcheck : enables tear check 65 * @get_vsync_info : retries timing info of the panel 66 * @setup_dither : function to program the dither hw block 67 * @get_line_count: obtain current vertical line counter 68 */ 69 struct dpu_hw_pingpong_ops { 70 /** 71 * enables vysnc generation and sets up init value of 72 * read pointer and programs the tear check cofiguration 73 */ 74 int (*setup_tearcheck)(struct dpu_hw_pingpong *pp, 75 struct dpu_hw_tear_check *cfg); 76 77 /** 78 * enables tear check block 79 */ 80 int (*enable_tearcheck)(struct dpu_hw_pingpong *pp, 81 bool enable); 82 83 /** 84 * read, modify, write to either set or clear listening to external TE 85 * @Return: 1 if TE was originally connected, 0 if not, or -ERROR 86 */ 87 int (*connect_external_te)(struct dpu_hw_pingpong *pp, 88 bool enable_external_te); 89 90 /** 91 * provides the programmed and current 92 * line_count 93 */ 94 int (*get_vsync_info)(struct dpu_hw_pingpong *pp, 95 struct dpu_hw_pp_vsync_info *info); 96 97 /** 98 * poll until write pointer transmission starts 99 * @Return: 0 on success, -ETIMEDOUT on timeout 100 */ 101 int (*poll_timeout_wr_ptr)(struct dpu_hw_pingpong *pp, u32 timeout_us); 102 103 /** 104 * Obtain current vertical line counter 105 */ 106 u32 (*get_line_count)(struct dpu_hw_pingpong *pp); 107 108 /** 109 * Setup dither matix for pingpong block 110 */ 111 void (*setup_dither)(struct dpu_hw_pingpong *pp, 112 struct dpu_hw_dither_cfg *cfg); 113 }; 114 115 struct dpu_hw_pingpong { 116 struct dpu_hw_blk base; 117 struct dpu_hw_blk_reg_map hw; 118 119 /* pingpong */ 120 enum dpu_pingpong idx; 121 const struct dpu_pingpong_cfg *caps; 122 123 /* ops */ 124 struct dpu_hw_pingpong_ops ops; 125 }; 126 127 /** 128 * to_dpu_hw_pingpong - convert base object dpu_hw_base to container 129 * @hw: Pointer to base hardware block 130 * return: Pointer to hardware block container 131 */ 132 static inline struct dpu_hw_pingpong *to_dpu_hw_pingpong(struct dpu_hw_blk *hw) 133 { 134 return container_of(hw, struct dpu_hw_pingpong, base); 135 } 136 137 /** 138 * dpu_hw_pingpong_init - initializes the pingpong driver for the passed 139 * pingpong idx. 140 * @idx: Pingpong index for which driver object is required 141 * @addr: Mapped register io address of MDP 142 * @m: Pointer to mdss catalog data 143 * Returns: Error code or allocated dpu_hw_pingpong context 144 */ 145 struct dpu_hw_pingpong *dpu_hw_pingpong_init(enum dpu_pingpong idx, 146 void __iomem *addr, 147 const struct dpu_mdss_cfg *m); 148 149 /** 150 * dpu_hw_pingpong_destroy - destroys pingpong driver context 151 * should be called to free the context 152 * @pp: Pointer to PP driver context returned by dpu_hw_pingpong_init 153 */ 154 void dpu_hw_pingpong_destroy(struct dpu_hw_pingpong *pp); 155 156 #endif /*_DPU_HW_PINGPONG_H */ 157