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