Linux Audio

Check our new training course

Embedded Linux training

Mar 31-Apr 8, 2025
Register
Loading...
Note: File does not exist in v4.6.
  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_UTIL_H
  6#define _DPU_HW_UTIL_H
  7
  8#include <linux/io.h>
  9#include <linux/slab.h>
 10#include "dpu_hw_mdss.h"
 11
 12#define REG_MASK(n)                     ((BIT(n)) - 1)
 13
 14/*
 15 * This is the common struct maintained by each sub block
 16 * for mapping the register offsets in this block to the
 17 * absoulute IO address
 18 * @base_off:     mdp register mapped offset
 19 * @blk_off:      pipe offset relative to mdss offset
 20 * @length        length of register block offset
 21 * @xin_id        xin id
 22 * @hwversion     mdss hw version number
 23 */
 24struct dpu_hw_blk_reg_map {
 25	void __iomem *base_off;
 26	u32 blk_off;
 27	u32 length;
 28	u32 xin_id;
 29	u32 hwversion;
 30	u32 log_mask;
 31};
 32
 33/**
 34 * struct dpu_hw_scaler3_de_cfg : QSEEDv3 detail enhancer configuration
 35 * @enable:         detail enhancer enable/disable
 36 * @sharpen_level1: sharpening strength for noise
 37 * @sharpen_level2: sharpening strength for signal
 38 * @ clip:          clip shift
 39 * @ limit:         limit value
 40 * @ thr_quiet:     quiet threshold
 41 * @ thr_dieout:    dieout threshold
 42 * @ thr_high:      low threshold
 43 * @ thr_high:      high threshold
 44 * @ prec_shift:    precision shift
 45 * @ adjust_a:      A-coefficients for mapping curve
 46 * @ adjust_b:      B-coefficients for mapping curve
 47 * @ adjust_c:      C-coefficients for mapping curve
 48 */
 49struct dpu_hw_scaler3_de_cfg {
 50	u32 enable;
 51	int16_t sharpen_level1;
 52	int16_t sharpen_level2;
 53	uint16_t clip;
 54	uint16_t limit;
 55	uint16_t thr_quiet;
 56	uint16_t thr_dieout;
 57	uint16_t thr_low;
 58	uint16_t thr_high;
 59	uint16_t prec_shift;
 60	int16_t adjust_a[DPU_MAX_DE_CURVES];
 61	int16_t adjust_b[DPU_MAX_DE_CURVES];
 62	int16_t adjust_c[DPU_MAX_DE_CURVES];
 63};
 64
 65
 66/**
 67 * struct dpu_hw_scaler3_cfg : QSEEDv3 configuration
 68 * @enable:        scaler enable
 69 * @dir_en:        direction detection block enable
 70 * @ init_phase_x: horizontal initial phase
 71 * @ phase_step_x: horizontal phase step
 72 * @ init_phase_y: vertical initial phase
 73 * @ phase_step_y: vertical phase step
 74 * @ preload_x:    horizontal preload value
 75 * @ preload_y:    vertical preload value
 76 * @ src_width:    source width
 77 * @ src_height:   source height
 78 * @ dst_width:    destination width
 79 * @ dst_height:   destination height
 80 * @ y_rgb_filter_cfg: y/rgb plane filter configuration
 81 * @ uv_filter_cfg: uv plane filter configuration
 82 * @ alpha_filter_cfg: alpha filter configuration
 83 * @ blend_cfg:    blend coefficients configuration
 84 * @ lut_flag:     scaler LUT update flags
 85 *                 0x1 swap LUT bank
 86 *                 0x2 update 2D filter LUT
 87 *                 0x4 update y circular filter LUT
 88 *                 0x8 update uv circular filter LUT
 89 *                 0x10 update y separable filter LUT
 90 *                 0x20 update uv separable filter LUT
 91 * @ dir_lut_idx:  2D filter LUT index
 92 * @ y_rgb_cir_lut_idx: y circular filter LUT index
 93 * @ uv_cir_lut_idx: uv circular filter LUT index
 94 * @ y_rgb_sep_lut_idx: y circular filter LUT index
 95 * @ uv_sep_lut_idx: uv separable filter LUT index
 96 * @ dir_lut:      pointer to 2D LUT
 97 * @ cir_lut:      pointer to circular filter LUT
 98 * @ sep_lut:      pointer to separable filter LUT
 99 * @ de: detail enhancer configuration
100 */
101struct dpu_hw_scaler3_cfg {
102	u32 enable;
103	u32 dir_en;
104	int32_t init_phase_x[DPU_MAX_PLANES];
105	int32_t phase_step_x[DPU_MAX_PLANES];
106	int32_t init_phase_y[DPU_MAX_PLANES];
107	int32_t phase_step_y[DPU_MAX_PLANES];
108
109	u32 preload_x[DPU_MAX_PLANES];
110	u32 preload_y[DPU_MAX_PLANES];
111	u32 src_width[DPU_MAX_PLANES];
112	u32 src_height[DPU_MAX_PLANES];
113
114	u32 dst_width;
115	u32 dst_height;
116
117	u32 y_rgb_filter_cfg;
118	u32 uv_filter_cfg;
119	u32 alpha_filter_cfg;
120	u32 blend_cfg;
121
122	u32 lut_flag;
123	u32 dir_lut_idx;
124
125	u32 y_rgb_cir_lut_idx;
126	u32 uv_cir_lut_idx;
127	u32 y_rgb_sep_lut_idx;
128	u32 uv_sep_lut_idx;
129	u32 *dir_lut;
130	size_t dir_len;
131	u32 *cir_lut;
132	size_t cir_len;
133	u32 *sep_lut;
134	size_t sep_len;
135
136	/*
137	 * Detail enhancer settings
138	 */
139	struct dpu_hw_scaler3_de_cfg de;
140};
141
142/**
143 * struct dpu_drm_pix_ext_v1 - version 1 of pixel ext structure
144 * @num_ext_pxls_lr: Number of total horizontal pixels
145 * @num_ext_pxls_tb: Number of total vertical lines
146 * @left_ftch:       Number of extra pixels to overfetch from left
147 * @right_ftch:      Number of extra pixels to overfetch from right
148 * @top_ftch:        Number of extra lines to overfetch from top
149 * @btm_ftch:        Number of extra lines to overfetch from bottom
150 * @left_rpt:        Number of extra pixels to repeat from left
151 * @right_rpt:       Number of extra pixels to repeat from right
152 * @top_rpt:         Number of extra lines to repeat from top
153 * @btm_rpt:         Number of extra lines to repeat from bottom
154 */
155struct dpu_drm_pix_ext_v1 {
156	/*
157	 * Number of pixels ext in left, right, top and bottom direction
158	 * for all color components.
159	 */
160	int32_t num_ext_pxls_lr[DPU_MAX_PLANES];
161	int32_t num_ext_pxls_tb[DPU_MAX_PLANES];
162
163	/*
164	 * Number of pixels needs to be overfetched in left, right, top
165	 * and bottom directions from source image for scaling.
166	 */
167	int32_t left_ftch[DPU_MAX_PLANES];
168	int32_t right_ftch[DPU_MAX_PLANES];
169	int32_t top_ftch[DPU_MAX_PLANES];
170	int32_t btm_ftch[DPU_MAX_PLANES];
171	/*
172	 * Number of pixels needs to be repeated in left, right, top and
173	 * bottom directions for scaling.
174	 */
175	int32_t left_rpt[DPU_MAX_PLANES];
176	int32_t right_rpt[DPU_MAX_PLANES];
177	int32_t top_rpt[DPU_MAX_PLANES];
178	int32_t btm_rpt[DPU_MAX_PLANES];
179
180};
181
182/**
183 * struct dpu_drm_de_v1 - version 1 of detail enhancer structure
184 * @enable:         Enables/disables detail enhancer
185 * @sharpen_level1: Sharpening strength for noise
186 * @sharpen_level2: Sharpening strength for context
187 * @clip:           Clip coefficient
188 * @limit:          Detail enhancer limit factor
189 * @thr_quiet:      Quite zone threshold
190 * @thr_dieout:     Die-out zone threshold
191 * @thr_low:        Linear zone left threshold
192 * @thr_high:       Linear zone right threshold
193 * @prec_shift:     Detail enhancer precision
194 * @adjust_a:       Mapping curves A coefficients
195 * @adjust_b:       Mapping curves B coefficients
196 * @adjust_c:       Mapping curves C coefficients
197 */
198struct dpu_drm_de_v1 {
199	uint32_t enable;
200	int16_t sharpen_level1;
201	int16_t sharpen_level2;
202	uint16_t clip;
203	uint16_t limit;
204	uint16_t thr_quiet;
205	uint16_t thr_dieout;
206	uint16_t thr_low;
207	uint16_t thr_high;
208	uint16_t prec_shift;
209	int16_t adjust_a[DPU_MAX_DE_CURVES];
210	int16_t adjust_b[DPU_MAX_DE_CURVES];
211	int16_t adjust_c[DPU_MAX_DE_CURVES];
212};
213
214/**
215 * struct dpu_drm_scaler_v2 - version 2 of struct dpu_drm_scaler
216 * @enable:            Scaler enable
217 * @dir_en:            Detail enhancer enable
218 * @pe:                Pixel extension settings
219 * @horz_decimate:     Horizontal decimation factor
220 * @vert_decimate:     Vertical decimation factor
221 * @init_phase_x:      Initial scaler phase values for x
222 * @phase_step_x:      Phase step values for x
223 * @init_phase_y:      Initial scaler phase values for y
224 * @phase_step_y:      Phase step values for y
225 * @preload_x:         Horizontal preload value
226 * @preload_y:         Vertical preload value
227 * @src_width:         Source width
228 * @src_height:        Source height
229 * @dst_width:         Destination width
230 * @dst_height:        Destination height
231 * @y_rgb_filter_cfg:  Y/RGB plane filter configuration
232 * @uv_filter_cfg:     UV plane filter configuration
233 * @alpha_filter_cfg:  Alpha filter configuration
234 * @blend_cfg:         Selection of blend coefficients
235 * @lut_flag:          LUT configuration flags
236 * @dir_lut_idx:       2d 4x4 LUT index
237 * @y_rgb_cir_lut_idx: Y/RGB circular LUT index
238 * @uv_cir_lut_idx:    UV circular LUT index
239 * @y_rgb_sep_lut_idx: Y/RGB separable LUT index
240 * @uv_sep_lut_idx:    UV separable LUT index
241 * @de:                Detail enhancer settings
242 */
243struct dpu_drm_scaler_v2 {
244	/*
245	 * General definitions
246	 */
247	uint32_t enable;
248	uint32_t dir_en;
249
250	/*
251	 * Pix ext settings
252	 */
253	struct dpu_drm_pix_ext_v1 pe;
254
255	/*
256	 * Decimation settings
257	 */
258	uint32_t horz_decimate;
259	uint32_t vert_decimate;
260
261	/*
262	 * Phase settings
263	 */
264	int32_t init_phase_x[DPU_MAX_PLANES];
265	int32_t phase_step_x[DPU_MAX_PLANES];
266	int32_t init_phase_y[DPU_MAX_PLANES];
267	int32_t phase_step_y[DPU_MAX_PLANES];
268
269	uint32_t preload_x[DPU_MAX_PLANES];
270	uint32_t preload_y[DPU_MAX_PLANES];
271	uint32_t src_width[DPU_MAX_PLANES];
272	uint32_t src_height[DPU_MAX_PLANES];
273
274	uint32_t dst_width;
275	uint32_t dst_height;
276
277	uint32_t y_rgb_filter_cfg;
278	uint32_t uv_filter_cfg;
279	uint32_t alpha_filter_cfg;
280	uint32_t blend_cfg;
281
282	uint32_t lut_flag;
283	uint32_t dir_lut_idx;
284
285	/* for Y(RGB) and UV planes*/
286	uint32_t y_rgb_cir_lut_idx;
287	uint32_t uv_cir_lut_idx;
288	uint32_t y_rgb_sep_lut_idx;
289	uint32_t uv_sep_lut_idx;
290
291	/*
292	 * Detail enhancer settings
293	 */
294	struct dpu_drm_de_v1 de;
295};
296
297
298u32 *dpu_hw_util_get_log_mask_ptr(void);
299
300void dpu_reg_write(struct dpu_hw_blk_reg_map *c,
301		u32 reg_off,
302		u32 val,
303		const char *name);
304int dpu_reg_read(struct dpu_hw_blk_reg_map *c, u32 reg_off);
305
306#define DPU_REG_WRITE(c, off, val) dpu_reg_write(c, off, val, #off)
307#define DPU_REG_READ(c, off) dpu_reg_read(c, off)
308
309void *dpu_hw_util_get_dir(void);
310
311void dpu_hw_setup_scaler3(struct dpu_hw_blk_reg_map *c,
312		struct dpu_hw_scaler3_cfg *scaler3_cfg,
313		u32 scaler_offset, u32 scaler_version,
314		const struct dpu_format *format);
315
316u32 dpu_hw_get_scaler3_ver(struct dpu_hw_blk_reg_map *c,
317		u32 scaler_offset);
318
319void dpu_hw_csc_setup(struct dpu_hw_blk_reg_map  *c,
320		u32 csc_reg_off,
321		struct dpu_csc_cfg *data, bool csc10);
322
323#endif /* _DPU_HW_UTIL_H */