197fb5e8dSThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-only */ 225fdd593SJeykumar Sankaran /* 325fdd593SJeykumar Sankaran * Copyright (c) 2016-2018, The Linux Foundation. All rights reserved. 425fdd593SJeykumar Sankaran */ 525fdd593SJeykumar Sankaran 625fdd593SJeykumar Sankaran #ifndef __DPU_RM_H__ 725fdd593SJeykumar Sankaran #define __DPU_RM_H__ 825fdd593SJeykumar Sankaran 925fdd593SJeykumar Sankaran #include <linux/list.h> 1025fdd593SJeykumar Sankaran 1125fdd593SJeykumar Sankaran #include "msm_kms.h" 1225fdd593SJeykumar Sankaran #include "dpu_hw_top.h" 1325fdd593SJeykumar Sankaran 14de3916c7SDrew Davenport struct dpu_global_state; 15bb00a452SDrew Davenport 1625fdd593SJeykumar Sankaran /** 1725fdd593SJeykumar Sankaran * struct dpu_rm - DPU dynamic hardware resource manager 18bb00a452SDrew Davenport * @pingpong_blks: array of pingpong hardware resources 19bb00a452SDrew Davenport * @mixer_blks: array of layer mixer hardware resources 20bb00a452SDrew Davenport * @ctl_blks: array of ctl hardware resources 21*ae57fdf0SDmitry Baryshkov * @hw_intf: array of intf hardware resources 22e47616dfSKalyan Thota * @dspp_blks: array of dspp hardware resources 2325fdd593SJeykumar Sankaran */ 2425fdd593SJeykumar Sankaran struct dpu_rm { 25bb00a452SDrew Davenport struct dpu_hw_blk *pingpong_blks[PINGPONG_MAX - PINGPONG_0]; 26bb00a452SDrew Davenport struct dpu_hw_blk *mixer_blks[LM_MAX - LM_0]; 27bb00a452SDrew Davenport struct dpu_hw_blk *ctl_blks[CTL_MAX - CTL_0]; 28*ae57fdf0SDmitry Baryshkov struct dpu_hw_intf *hw_intf[INTF_MAX - INTF_0]; 29e47616dfSKalyan Thota struct dpu_hw_blk *dspp_blks[DSPP_MAX - DSPP_0]; 304369c93cSDmitry Baryshkov struct dpu_hw_blk *merge_3d_blks[MERGE_3D_MAX - MERGE_3D_0]; 3125fdd593SJeykumar Sankaran }; 3225fdd593SJeykumar Sankaran 3325fdd593SJeykumar Sankaran /** 3425fdd593SJeykumar Sankaran * dpu_rm_init - Read hardware catalog and create reservation tracking objects 3525fdd593SJeykumar Sankaran * for all HW blocks. 3625fdd593SJeykumar Sankaran * @rm: DPU Resource Manager handle 3725fdd593SJeykumar Sankaran * @cat: Pointer to hardware catalog 3825fdd593SJeykumar Sankaran * @mmio: mapped register io address of MDP 3925fdd593SJeykumar Sankaran * @Return: 0 on Success otherwise -ERROR 4025fdd593SJeykumar Sankaran */ 4125fdd593SJeykumar Sankaran int dpu_rm_init(struct dpu_rm *rm, 4225fdd593SJeykumar Sankaran struct dpu_mdss_cfg *cat, 433763f1a5SJeykumar Sankaran void __iomem *mmio); 4425fdd593SJeykumar Sankaran 4525fdd593SJeykumar Sankaran /** 4625fdd593SJeykumar Sankaran * dpu_rm_destroy - Free all memory allocated by dpu_rm_init 4725fdd593SJeykumar Sankaran * @rm: DPU Resource Manager handle 4825fdd593SJeykumar Sankaran * @Return: 0 on Success otherwise -ERROR 4925fdd593SJeykumar Sankaran */ 5025fdd593SJeykumar Sankaran int dpu_rm_destroy(struct dpu_rm *rm); 5125fdd593SJeykumar Sankaran 5225fdd593SJeykumar Sankaran /** 5325fdd593SJeykumar Sankaran * dpu_rm_reserve - Given a CRTC->Encoder->Connector display chain, analyze 5425fdd593SJeykumar Sankaran * the use connections and user requirements, specified through related 5525fdd593SJeykumar Sankaran * topology control properties, and reserve hardware blocks to that 5625fdd593SJeykumar Sankaran * display chain. 5725fdd593SJeykumar Sankaran * HW blocks can then be accessed through dpu_rm_get_* functions. 5825fdd593SJeykumar Sankaran * HW Reservations should be released via dpu_rm_release_hw. 5925fdd593SJeykumar Sankaran * @rm: DPU Resource Manager handle 6025fdd593SJeykumar Sankaran * @drm_enc: DRM Encoder handle 6125fdd593SJeykumar Sankaran * @crtc_state: Proposed Atomic DRM CRTC State handle 6225fdd593SJeykumar Sankaran * @topology: Pointer to topology info for the display 6325fdd593SJeykumar Sankaran * @Return: 0 on Success otherwise -ERROR 6425fdd593SJeykumar Sankaran */ 6525fdd593SJeykumar Sankaran int dpu_rm_reserve(struct dpu_rm *rm, 66de3916c7SDrew Davenport struct dpu_global_state *global_state, 6725fdd593SJeykumar Sankaran struct drm_encoder *drm_enc, 6825fdd593SJeykumar Sankaran struct drm_crtc_state *crtc_state, 69de3916c7SDrew Davenport struct msm_display_topology topology); 7025fdd593SJeykumar Sankaran 7125fdd593SJeykumar Sankaran /** 7225fdd593SJeykumar Sankaran * dpu_rm_reserve - Given the encoder for the display chain, release any 7325fdd593SJeykumar Sankaran * HW blocks previously reserved for that use case. 7425fdd593SJeykumar Sankaran * @rm: DPU Resource Manager handle 7525fdd593SJeykumar Sankaran * @enc: DRM Encoder handle 7625fdd593SJeykumar Sankaran * @Return: 0 on Success otherwise -ERROR 7725fdd593SJeykumar Sankaran */ 78de3916c7SDrew Davenport void dpu_rm_release(struct dpu_global_state *global_state, 79de3916c7SDrew Davenport struct drm_encoder *enc); 8025fdd593SJeykumar Sankaran 8125fdd593SJeykumar Sankaran /** 82b954fa6bSDrew Davenport * Get hw resources of the given type that are assigned to this encoder. 8325fdd593SJeykumar Sankaran */ 84de3916c7SDrew Davenport int dpu_rm_get_assigned_resources(struct dpu_rm *rm, 85de3916c7SDrew Davenport struct dpu_global_state *global_state, uint32_t enc_id, 86b954fa6bSDrew Davenport enum dpu_hw_blk_type type, struct dpu_hw_blk **blks, int blks_size); 87ef58e0adSDmitry Baryshkov 88ef58e0adSDmitry Baryshkov /** 89ef58e0adSDmitry Baryshkov * dpu_rm_get_intf - Return a struct dpu_hw_intf instance given it's index. 90ef58e0adSDmitry Baryshkov * @rm: DPU Resource Manager handle 91ef58e0adSDmitry Baryshkov * @intf_idx: INTF's index 92ef58e0adSDmitry Baryshkov */ 93*ae57fdf0SDmitry Baryshkov static inline struct dpu_hw_intf *dpu_rm_get_intf(struct dpu_rm *rm, enum dpu_intf intf_idx) 94*ae57fdf0SDmitry Baryshkov { 95*ae57fdf0SDmitry Baryshkov return rm->hw_intf[intf_idx - INTF_0]; 96*ae57fdf0SDmitry Baryshkov } 97ef58e0adSDmitry Baryshkov 9825fdd593SJeykumar Sankaran #endif /* __DPU_RM_H__ */ 99b954fa6bSDrew Davenport 100