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_DSPP_H 6 #define _DPU_HW_DSPP_H 7 8 struct dpu_hw_dspp; 9 10 /** 11 * struct dpu_hw_pcc_coeff - PCC coefficient structure for each color 12 * component. 13 * @r: red coefficient. 14 * @g: green coefficient. 15 * @b: blue coefficient. 16 */ 17 18 struct dpu_hw_pcc_coeff { 19 __u32 r; 20 __u32 g; 21 __u32 b; 22 }; 23 24 /** 25 * struct dpu_hw_pcc - pcc feature structure 26 * @r: red coefficients. 27 * @g: green coefficients. 28 * @b: blue coefficients. 29 */ 30 struct dpu_hw_pcc_cfg { 31 struct dpu_hw_pcc_coeff r; 32 struct dpu_hw_pcc_coeff g; 33 struct dpu_hw_pcc_coeff b; 34 }; 35 36 /** 37 * struct dpu_hw_dspp_ops - interface to the dspp hardware driver functions 38 * Caller must call the init function to get the dspp context for each dspp 39 * Assumption is these functions will be called after clocks are enabled 40 */ 41 struct dpu_hw_dspp_ops { 42 /** 43 * setup_pcc - setup dspp pcc 44 * @ctx: Pointer to dspp context 45 * @cfg: Pointer to configuration 46 */ 47 void (*setup_pcc)(struct dpu_hw_dspp *ctx, struct dpu_hw_pcc_cfg *cfg); 48 49 }; 50 51 /** 52 * struct dpu_hw_dspp - dspp description 53 * @base: Hardware block base structure 54 * @hw: Block hardware details 55 * @idx: DSPP index 56 * @cap: Pointer to layer_cfg 57 * @ops: Pointer to operations possible for this DSPP 58 */ 59 struct dpu_hw_dspp { 60 struct dpu_hw_blk base; 61 struct dpu_hw_blk_reg_map hw; 62 63 /* dspp */ 64 int idx; 65 const struct dpu_dspp_cfg *cap; 66 67 /* Ops */ 68 struct dpu_hw_dspp_ops ops; 69 }; 70 71 /** 72 * dpu_hw_dspp - convert base object dpu_hw_base to container 73 * @hw: Pointer to base hardware block 74 * return: Pointer to hardware block container 75 */ 76 static inline struct dpu_hw_dspp *to_dpu_hw_dspp(struct dpu_hw_blk *hw) 77 { 78 return container_of(hw, struct dpu_hw_dspp, base); 79 } 80 81 /** 82 * dpu_hw_dspp_init() - Initializes the DSPP hw driver object. 83 * should be called once before accessing every DSPP. 84 * @cfg: DSPP catalog entry for which driver object is required 85 * @addr: Mapped register io address of MDP 86 * Return: pointer to structure or ERR_PTR 87 */ 88 struct dpu_hw_dspp *dpu_hw_dspp_init(const struct dpu_dspp_cfg *cfg, 89 void __iomem *addr); 90 91 /** 92 * dpu_hw_dspp_destroy(): Destroys DSPP driver context 93 * @dspp: Pointer to DSPP driver context 94 */ 95 void dpu_hw_dspp_destroy(struct dpu_hw_dspp *dspp); 96 97 #endif /*_DPU_HW_DSPP_H */ 98 99