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_VBIF_H 6 #define _DPU_HW_VBIF_H 7 8 #include "dpu_hw_catalog.h" 9 #include "dpu_hw_mdss.h" 10 #include "dpu_hw_util.h" 11 12 struct dpu_hw_vbif; 13 14 /** 15 * struct dpu_hw_vbif_ops : Interface to the VBIF hardware driver functions 16 * Assumption is these functions will be called after clocks are enabled 17 */ 18 struct dpu_hw_vbif_ops { 19 /** 20 * set_limit_conf - set transaction limit config 21 * @vbif: vbif context driver 22 * @xin_id: client interface identifier 23 * @rd: true for read limit; false for write limit 24 * @limit: outstanding transaction limit 25 */ 26 void (*set_limit_conf)(struct dpu_hw_vbif *vbif, 27 u32 xin_id, bool rd, u32 limit); 28 29 /** 30 * get_limit_conf - get transaction limit config 31 * @vbif: vbif context driver 32 * @xin_id: client interface identifier 33 * @rd: true for read limit; false for write limit 34 * @return: outstanding transaction limit 35 */ 36 u32 (*get_limit_conf)(struct dpu_hw_vbif *vbif, 37 u32 xin_id, bool rd); 38 39 /** 40 * set_halt_ctrl - set halt control 41 * @vbif: vbif context driver 42 * @xin_id: client interface identifier 43 * @enable: halt control enable 44 */ 45 void (*set_halt_ctrl)(struct dpu_hw_vbif *vbif, 46 u32 xin_id, bool enable); 47 48 /** 49 * get_halt_ctrl - get halt control 50 * @vbif: vbif context driver 51 * @xin_id: client interface identifier 52 * @return: halt control enable 53 */ 54 bool (*get_halt_ctrl)(struct dpu_hw_vbif *vbif, 55 u32 xin_id); 56 57 /** 58 * set_qos_remap - set QoS priority remap 59 * @vbif: vbif context driver 60 * @xin_id: client interface identifier 61 * @level: priority level 62 * @remap_level: remapped level 63 */ 64 void (*set_qos_remap)(struct dpu_hw_vbif *vbif, 65 u32 xin_id, u32 level, u32 remap_level); 66 67 /** 68 * set_mem_type - set memory type 69 * @vbif: vbif context driver 70 * @xin_id: client interface identifier 71 * @value: memory type value 72 */ 73 void (*set_mem_type)(struct dpu_hw_vbif *vbif, 74 u32 xin_id, u32 value); 75 76 /** 77 * clear_errors - clear any vbif errors 78 * This function clears any detected pending/source errors 79 * on the VBIF interface, and optionally returns the detected 80 * error mask(s). 81 * @vbif: vbif context driver 82 * @pnd_errors: pointer to pending error reporting variable 83 * @src_errors: pointer to source error reporting variable 84 */ 85 void (*clear_errors)(struct dpu_hw_vbif *vbif, 86 u32 *pnd_errors, u32 *src_errors); 87 88 /** 89 * set_write_gather_en - set write_gather enable 90 * @vbif: vbif context driver 91 * @xin_id: client interface identifier 92 */ 93 void (*set_write_gather_en)(struct dpu_hw_vbif *vbif, u32 xin_id); 94 }; 95 96 struct dpu_hw_vbif { 97 /* base */ 98 struct dpu_hw_blk_reg_map hw; 99 100 /* vbif */ 101 enum dpu_vbif idx; 102 const struct dpu_vbif_cfg *cap; 103 104 /* ops */ 105 struct dpu_hw_vbif_ops ops; 106 }; 107 108 /** 109 * dpu_hw_vbif_init - initializes the vbif driver for the passed interface idx 110 * @idx: Interface index for which driver object is required 111 * @addr: Mapped register io address of MDSS 112 * @m: Pointer to mdss catalog data 113 */ 114 struct dpu_hw_vbif *dpu_hw_vbif_init(enum dpu_vbif idx, 115 void __iomem *addr, 116 const struct dpu_mdss_cfg *m); 117 118 void dpu_hw_vbif_destroy(struct dpu_hw_vbif *vbif); 119 120 #endif /*_DPU_HW_VBIF_H */ 121