1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * Copyright (c) 2020-2022, Linaro Limited 4 * Copyright (c) 2023 Qualcomm Innovation Center, Inc. All rights reserved 5 */ 6 7 #ifndef _DPU_HW_DSC_H 8 #define _DPU_HW_DSC_H 9 10 #include <drm/display/drm_dsc.h> 11 12 #define DSC_MODE_SPLIT_PANEL BIT(0) 13 #define DSC_MODE_MULTIPLEX BIT(1) 14 #define DSC_MODE_VIDEO BIT(2) 15 16 struct dpu_hw_dsc; 17 18 /** 19 * struct dpu_hw_dsc_ops - interface to the dsc hardware driver functions 20 * Assumption is these functions will be called after clocks are enabled 21 */ 22 struct dpu_hw_dsc_ops { 23 /** 24 * dsc_disable - disable dsc 25 * @hw_dsc: Pointer to dsc context 26 */ 27 void (*dsc_disable)(struct dpu_hw_dsc *hw_dsc); 28 29 /** 30 * dsc_config - configures dsc encoder 31 * @hw_dsc: Pointer to dsc context 32 * @dsc: panel dsc parameters 33 * @mode: dsc topology mode to be set 34 * @initial_lines: amount of initial lines to be used 35 */ 36 void (*dsc_config)(struct dpu_hw_dsc *hw_dsc, 37 struct drm_dsc_config *dsc, 38 u32 mode, 39 u32 initial_lines); 40 41 /** 42 * dsc_config_thresh - programs panel thresholds 43 * @hw_dsc: Pointer to dsc context 44 * @dsc: panel dsc parameters 45 */ 46 void (*dsc_config_thresh)(struct dpu_hw_dsc *hw_dsc, 47 struct drm_dsc_config *dsc); 48 49 void (*dsc_bind_pingpong_blk)(struct dpu_hw_dsc *hw_dsc, 50 enum dpu_pingpong pp); 51 }; 52 53 struct dpu_hw_dsc { 54 struct dpu_hw_blk base; 55 struct dpu_hw_blk_reg_map hw; 56 57 /* dsc */ 58 enum dpu_dsc idx; 59 const struct dpu_dsc_cfg *caps; 60 61 /* ops */ 62 struct dpu_hw_dsc_ops ops; 63 }; 64 65 /** 66 * dpu_hw_dsc_init() - Initializes the DSC hw driver object. 67 * @dev: Corresponding device for devres management 68 * @cfg: DSC catalog entry for which driver object is required 69 * @addr: Mapped register io address of MDP 70 * Return: Error code or allocated dpu_hw_dsc context 71 */ 72 struct dpu_hw_dsc *dpu_hw_dsc_init(struct drm_device *dev, 73 const struct dpu_dsc_cfg *cfg, 74 void __iomem *addr); 75 76 /** 77 * dpu_hw_dsc_init_1_2() - initializes the v1.2 DSC hw driver object 78 * @dev: Corresponding device for devres management 79 * @cfg: DSC catalog entry for which driver object is required 80 * @addr: Mapped register io address of MDP 81 * Returns: Error code or allocated dpu_hw_dsc context 82 */ 83 struct dpu_hw_dsc *dpu_hw_dsc_init_1_2(struct drm_device *dev, 84 const struct dpu_dsc_cfg *cfg, 85 void __iomem *addr); 86 87 /** 88 * dpu_hw_dsc_destroy - destroys dsc driver context 89 * @dsc: Pointer to dsc driver context returned by dpu_hw_dsc_init 90 */ 91 void dpu_hw_dsc_destroy(struct dpu_hw_dsc *dsc); 92 93 static inline struct dpu_hw_dsc *to_dpu_hw_dsc(struct dpu_hw_blk *hw) 94 { 95 return container_of(hw, struct dpu_hw_dsc, base); 96 } 97 98 #endif /* _DPU_HW_DSC_H */ 99