/* * Copyright (c) 2021-2023 Qualcomm Innovation Center, Inc. All rights reserved. * Copyright (c) 2015-2021 The Linux Foundation. All rights reserved. * Copyright (C) 2013 Red Hat * Author: Rob Clark * * This program is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 as published by * the Free Software Foundation. * * This program is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for * more details. * * You should have received a copy of the GNU General Public License along with * this program. If not, see . */ #ifndef _SDE_CRTC_H_ #define _SDE_CRTC_H_ #include #include #include #include #include "msm_prop.h" #include "sde_fence.h" #include "sde_kms.h" #include "sde_core_perf.h" #include "sde_hw_ds.h" #include "sde_color_processing.h" #include "sde_encoder.h" #define SDE_CRTC_NAME_SIZE 12 /* define the maximum number of in-flight frame events */ /* Expand it to 2x for handling atleast 2 connectors safely */ #define SDE_CRTC_EVENT_SIZE (4 * 2) /** * enum sde_crtc_client_type: crtc client type * @RT_CLIENT: RealTime client like video/cmd mode display * voting through apps rsc * @NRT_CLIENT: Non-RealTime client like WB display * voting through apps rsc * @RT_RSC_CLIENT: Realtime display RSC voting client */ enum sde_crtc_client_type { RT_CLIENT, NRT_CLIENT, RT_RSC_CLIENT, }; /** * enum sde_crtc_output_capture_point * @MIXER_OUT : capture mixer output * @DSPP_OUT : capture output of dspp * @CAPTURE_DEMURA_OUT : capture output of demura */ enum sde_crtc_output_capture_point { CAPTURE_MIXER_OUT, CAPTURE_DSPP_OUT, CAPTURE_DEMURA_OUT }; /** * enum fence_error_handle_flag: the flag to enable/disable fence error handling in kernel * @FENCE_ERROR_HANDLE_DISABLE : disable fence error handling in kernel * @FENCE_ERROR_HANDLE_ENABLE : enable fence error handling in kernel */ enum fence_error_handle_flag { FENCE_ERROR_HANDLE_DISABLE, FENCE_ERROR_HANDLE_ENABLE, }; /** * enum sde_crtc_idle_pc_state: states of idle power collapse * @IDLE_PC_NONE: no-op * @IDLE_PC_ENABLE: enable idle power-collapse * @IDLE_PC_DISABLE: disable idle power-collapse */ enum sde_crtc_idle_pc_state { IDLE_PC_NONE, IDLE_PC_ENABLE, IDLE_PC_DISABLE, }; /** * enum sde_crtc_vm_req: request for VM operations * @VM_REQ_NONE: no request. Normal VM operations. * @VM_REQ_RELEASE: request to release the HW resources from the current VM * @VM_REQ_ACQUIRE: request to acquire the HW resources in the current VM */ enum sde_crtc_vm_req { VM_REQ_NONE, VM_REQ_RELEASE, VM_REQ_ACQUIRE, }; /** * @connectors : Currently associated drm connectors for retire event * @num_connectors: Number of associated drm connectors for retire event * @list: event list */ struct sde_crtc_retire_event { struct drm_connector *connectors[MAX_CONNECTORS]; int num_connectors; struct list_head list; }; /** * struct sde_crtc_mixer: stores the map for each virtual pipeline in the CRTC * @hw_lm: LM HW Driver context * @hw_ctl: CTL Path HW driver context * @hw_dspp: DSPP HW driver context * @hw_ds: DS HW driver context * @encoder: Encoder attached to this lm & ctl * @mixer_op_mode: mixer blending operation mode */ struct sde_crtc_mixer { struct sde_hw_mixer *hw_lm; struct sde_hw_ctl *hw_ctl; struct sde_hw_dspp *hw_dspp; struct sde_hw_ds *hw_ds; struct drm_encoder *encoder; u32 mixer_op_mode; }; /** * struct sde_crtc_frame_event: stores crtc frame event for crtc processing * @work: base work structure * @crtc: Pointer to crtc handling this event * @connector: pointer to drm connector which is source of frame event * @list: event list * @ts: timestamp at queue entry * @event: event identifier */ struct sde_crtc_frame_event { struct kthread_work work; struct drm_crtc *crtc; struct drm_connector *connector; struct list_head list; ktime_t ts; u32 event; }; /** * struct sde_crtc_vblank_event: vblank notify event * @work: base work structure * @crtc: Pointer to crtc handling this event * @list: vblank list * @ts: vblank timestamp */ struct sde_crtc_vblank_event { struct kthread_work work; struct drm_crtc *crtc; struct list_head list; ktime_t ts; }; /** * struct sde_crtc_event - event callback tracking structure * @list: Linked list tracking node * @kt_work: Kthread worker structure * @sde_crtc: Pointer to associated sde_crtc structure * @cb_func: Pointer to callback function * @usr: Pointer to user data to be provided to the callback */ struct sde_crtc_event { struct list_head list; struct kthread_work kt_work; void *sde_crtc; void (*cb_func)(struct drm_crtc *crtc, void *usr); void *usr; }; /** * struct sde_crtc_fps_info - structure for measuring fps periodicity * @frame_count : Total frames during configured periodic duration * @last_sampled_time_us: Stores the last ktime in microsecs when fps * was calculated * @measured_fps : Last measured fps value * @fps_periodic_duration : Duration in milliseconds to measure the fps. * Default value is 1 second. * @time_buf : Buffer for storing ktime of the commits * @next_time_index : index into time_buf for storing ktime for next commit */ struct sde_crtc_fps_info { u32 frame_count; ktime_t last_sampled_time_us; u32 measured_fps; u32 fps_periodic_duration; ktime_t *time_buf; u32 next_time_index; }; /** * struct sde_ltm_buffer - defines LTM buffer structure. * @fb: frm framebuffer for the buffer * @gem: drm gem handle for the buffer * @asapce : pointer to address space * @drm_fb_id: framebuffer id associated with this buffer * @offset: offset for alignment * @iova: device address * @kva: kernel virtual address * @node: list node for LTM buffer list; */ struct sde_ltm_buffer { struct drm_framebuffer *fb; struct drm_gem_object *gem; struct msm_gem_address_space *aspace; u32 drm_fb_id; u32 offset; u64 iova; void *kva; struct list_head node; }; /** * struct sde_crtc_misr_info - structure for misr information * @misr_enable : enable/disable flag * @misr_frame_count : Number of frames for misr calculation. */ struct sde_crtc_misr_info { bool misr_enable; u32 misr_frame_count; }; /* * Maximum number of free event structures to cache */ #define SDE_CRTC_MAX_EVENT_COUNT 16 /** * struct sde_frame_data_buffer - defines frame data buffer structure * @fd: framebuffer id associated with this buffer * @fb: drm framebuffer for the buffer * @gem: drm gem handle for he buffer */ struct sde_frame_data_buffer { u32 fd; struct drm_framebuffer *fb; struct drm_gem_object *gem; }; /** * struct sde_frame_data - defines sde frame data structure * @idx : currently used frame data buffe * @cnt : rnumber of available frame data buffers * @buf : list of frame data buffers */ struct sde_frame_data { u32 idx; u32 cnt; struct sde_frame_data_buffer *buf[SDE_FRAME_DATA_BUFFER_MAX]; }; /** * struct sde_opr_value - defines sde opr value structure * @num_valid_opr : count of valid opr values * @opr_value : list of opr value */ struct sde_opr_value { atomic_t num_valid_opr; u32 opr_value[MAX_DSI_DISPLAYS]; }; /** * enum sde_crtc_hw_fence_flags - flags to enable/disable hw fence features * @HW_FENCE_OUT_FENCES_ENABLE: enables creation of hw fences for crtc output fences * @HW_FENCE_IN_FENCES_ENABLE: enables hw fences for input-fences that are candidates for hw wait * (i.e. they have the dma-fence flag for dma-fences set), this allows to * selectively enable/disable input-fences, regardless of the dma-fence flags. * @HW_FENCE-IN_FENCES_NO_OVERRIDE: skip the sw-override of the input hw-fences signal. * @HW_FENCE_FEATURES_MAX: max number of features. */ enum sde_crtc_hw_fence_flags { HW_FENCE_OUT_FENCES_ENABLE, HW_FENCE_IN_FENCES_ENABLE, HW_FENCE_IN_FENCES_NO_OVERRIDE, HW_FENCE_FEATURES_MAX, }; /** * struct sde_crtc - virtualized CRTC data structure * @base : Base drm crtc structure * @name : ASCII description of this crtc * @num_ctls : Number of ctl paths in use * @num_mixers : Number of mixers in use * @mixers_swapped: Whether the mixers have been swapped for left/right update * especially in the case of DSC Merge. * @mixers : List of active mixers * @event : Pointer to last received drm vblank event. If there is a * pending vblank event, this will be non-null. * @vsync_count : Running count of received vsync events * @drm_requested_vblank : Whether vblanks have been enabled in the encoder * @property_info : Opaque structure for generic property support * @property_defaults : Array of default values for generic property support * @output_fence : output release fence context * @stage_cfg : H/w mixer stage configuration * @debugfs_root : Parent of debugfs node * @priv_handle : Pointer to external private handle, if present * @vblank_cb_count : count of vblank callback since last reset * @play_count : frame count between crtc enable and disable * @vblank_cb_time : ktime at vblank count reset * @vblank_last_cb_time : ktime at last vblank notification * @retire_frame_event_time : ktime at last retire frame event * @sysfs_dev : sysfs device node for crtc * @vsync_event_sf : vsync event notifier sysfs device * @retire_frame_event_sf :retire frame event notifier sysfs device * @enabled : whether the SDE CRTC is currently enabled. updated in the * commit-thread, not state-swap time which is earlier, so * safe to make decisions on during VBLANK on/off work * @cp_feature_list : list of color processing features supported on a crtc * @cp_active_list : list of color processing features are active * @cp_dirty_list : list of color processing features are dirty * @revalidate_mask : stores dirty flags to revalidate after idlepc * @ad_dirty : list containing ad properties that are dirty * @ad_active : list containing ad properties that are active * @crtc_lock : crtc lock around create, destroy and access. * @frame_pending : Whether or not an update is pending * @kickoff_in_progress : boolean entry to check if kickoff is in progress * @frame_events : static allocation of in-flight frame events * @frame_event_list : available frame event list * @vblank_events : static allocation of in-flight vblank events * @vblank_event_list : available vblank event list * @spin_lock : spin lock for transaction status, etc... * @event_spin_lock : spin lock for all the event lists * @event_thread : Pointer to event handler thread * @event_worker : Event worker queue * @event_cache : Local cache of event worker structures * @event_free_list : List of available event structures * @event_lock : Spinlock around event handling code * @misr_enable_sui : boolean entry indicates misr enable/disable status * for secure cases. * @misr_enable_debugfs : boolean entry indicates misr enable/disable status * from debugfs. * @misr_reconfigure : boolean entry indicates misr reconfigure status * @misr_frame_count : misr frame count provided by client * @misr_data : store misr data before turning off the clocks. * @power_event : registered power event handle * @cur_perf : current performance committed to clock/bandwidth driver * @plane_mask_old: keeps track of the planes used in the previous commit * @frame_trigger_mode: frame trigger mode * @cp_pu_feature_mask: mask indicating cp feature enable for partial update * @ltm_buffer_cnt : number of ltm buffers * @ltm_buffers : struct stores ltm buffer related data * @ltm_buf_free : list of LTM buffers that are available * @ltm_buf_busy : list of LTM buffers that are been used by HW * @ltm_hist_en : flag to indicate whether LTM hist is enabled or not * @ltm_merge_clear_pending : flag indicates merge mode bit needs to be cleared * @ltm_buffer_lock : muttx to protect ltm_buffers allcation and free * @ltm_lock : Spinlock to protect ltm buffer_cnt, hist_en and ltm lists * @needs_hw_reset : Initiate a hw ctl reset * @reinit_crtc_mixers : Reinitialize mixers in crtc * @hist_irq_idx : hist interrupt irq idx * @disable_pending_cp : flag tracks pending color processing features force disable * @src_bpp : source bpp used to calculate compression ratio * @target_bpp : target bpp used to calculate compression ratio * @static_cache_read_work: delayed worker to transition cache state to read * @cache_state : Current static image cache state * @cache_type : Current static image cache type to use * @dspp_blob_info : blob containing dspp hw capability information * @cached_encoder_mask : cached encoder_mask for vblank work * @valid_skip_blend_plane: flag to indicate if skip blend plane is valid * @skip_blend_plane: enabled plane that has skip blending * @skip_blend_plane_w: skip blend plane width * @skip_blend_plane_h: skip blend plane height * @line_time_in_ns : current mode line time in nano sec is needed for QOS update * @frame_data : Framedata data structure * @previous_opr_value : store previous opr values * @opr_event_notify_enabled : Flag to indicate if opr event notify is enabled or not * @hwfence_features_mask : u32 mask to enable/disable hw fence features. See enum * sde_crtc_hw_fence_flags for available fields. * @hwfence_out_fences_skip: number of frames to skip before create a new hw-fence, this can be * used to slow-down creation of output hw-fences for debugging purposes. * @input_fence_status : input fence status, negative if the fence has been completed with error. * @hanle_fence_error_bw_update: bool to indicate if it is fence error and need to avoid bw vote. * @back_light: backlight value * @back_light_max: max backlight value * @back_light_pending: flag to indicate if backlight update is pending */ struct sde_crtc { struct drm_crtc base; char name[SDE_CRTC_NAME_SIZE]; /* HW Resources reserved for the crtc */ u32 num_ctls; u32 num_mixers; bool mixers_swapped; struct sde_crtc_mixer mixers[MAX_MIXERS_PER_CRTC]; struct drm_pending_vblank_event *event; u32 vsync_count; struct msm_property_info property_info; struct msm_property_data property_data[CRTC_PROP_COUNT]; struct drm_property_blob *blob_info; /* output fence support */ struct sde_fence_context *output_fence; struct sde_hw_stage_cfg stage_cfg[MAX_LAYOUTS_PER_CRTC]; struct dentry *debugfs_root; void *priv_handle; u32 vblank_cb_count; u64 play_count; ktime_t vblank_cb_time; ktime_t vblank_last_cb_time; ktime_t retire_frame_event_time; struct sde_crtc_fps_info fps_info; struct device *sysfs_dev; struct kernfs_node *vsync_event_sf; struct kernfs_node *retire_frame_event_sf; bool enabled; struct list_head cp_feature_list; struct list_head cp_active_list; struct list_head cp_dirty_list; struct list_head ad_dirty; struct list_head ad_active; struct list_head user_event_list; struct mutex crtc_lock; struct mutex crtc_cp_lock; atomic_t frame_pending; struct sde_crtc_frame_event frame_events[SDE_CRTC_EVENT_SIZE]; struct list_head frame_event_list; struct sde_crtc_vblank_event vblank_events[SDE_CRTC_EVENT_SIZE]; struct list_head vblank_event_list; spinlock_t spin_lock; spinlock_t event_spin_lock; bool kickoff_in_progress; unsigned long revalidate_mask; /* for handling internal event thread */ struct sde_crtc_event event_cache[SDE_CRTC_MAX_EVENT_COUNT]; struct list_head event_free_list; spinlock_t event_lock; bool misr_enable_sui; bool misr_enable_debugfs; bool misr_reconfigure; u32 misr_frame_count; struct sde_power_event *power_event; struct sde_core_perf_params cur_perf; struct sde_core_perf_params new_perf; u32 plane_mask_old; /* blob for histogram data */ struct drm_property_blob *hist_blob; enum frame_trigger_mode_type frame_trigger_mode; u32 cp_pu_feature_mask; u32 ltm_buffer_cnt; struct sde_ltm_buffer *ltm_buffers[LTM_BUFFER_SIZE]; struct list_head ltm_buf_free; struct list_head ltm_buf_busy; bool ltm_hist_en; bool ltm_merge_clear_pending; struct drm_msm_ltm_cfg_param ltm_cfg; struct mutex ltm_buffer_lock; spinlock_t ltm_lock; bool needs_hw_reset; bool reinit_crtc_mixers; int hist_irq_idx; bool disable_pending_cp; int src_bpp; int target_bpp; struct kthread_delayed_work static_cache_read_work; enum sde_sys_cache_state cache_state; enum sde_sys_cache_type cache_type; struct drm_property_blob *dspp_blob_info; u32 cached_encoder_mask; bool valid_skip_blend_plane; enum sde_sspp skip_blend_plane; u32 skip_blend_plane_w; u32 skip_blend_plane_h; u32 line_time_in_ns; struct sde_frame_data frame_data; struct sde_opr_value previous_opr_value; bool opr_event_notify_enabled; DECLARE_BITMAP(hwfence_features_mask, HW_FENCE_FEATURES_MAX); u32 hwfence_out_fences_skip; int input_fence_status; bool handle_fence_error_bw_update; u32 back_light; u32 back_light_max; u32 back_light_pending; }; enum sde_crtc_dirty_flags { SDE_CRTC_DIRTY_DEST_SCALER, SDE_CRTC_DIRTY_DIM_LAYERS, SDE_CRTC_NOISE_LAYER, SDE_CRTC_DIRTY_MAX, }; #define to_sde_crtc(x) container_of(x, struct sde_crtc, base) /** * struct sde_line_insertion_param - sde line insertion parameters * @panel_line_insertion_enable: line insertion support status * @padding_height: panel height after line padding * @padding_active: active lines in panel stacking pattern * @padding_dummy: dummy lines in panel stacking pattern */ struct sde_line_insertion_param { bool panel_line_insertion_enable; u32 padding_height; u32 padding_active; u32 padding_dummy; }; /** * struct sde_crtc_state - sde container for atomic crtc state * @base: Base drm crtc state structure * @connectors : Currently associated drm connectors * @num_connectors: Number of associated drm connectors * @rsc_client : sde rsc client when mode is valid * @is_ppsplit : Whether current topology requires PPSplit special handling * @bw_control : true if bw/clk controlled by core bw/clk properties * @bw_split_vote : true if bw controlled by llcc/dram bw properties * @crtc_roi : Current CRTC ROI. Possibly sub-rectangle of mode. * Origin top left of CRTC. * @lm_bounds : LM boundaries based on current mode full resolution, no ROI. * Origin top left of CRTC. * @lm_roi : Current LM ROI, possibly sub-rectangle of mode. * Origin top left of CRTC. * @user_roi_list : List of user's requested ROIs as from set property * @cached_user_roi_list : Copy of user_roi_list from previous PU frame * @property_state: Local storage for msm_prop properties * @property_values: Current crtc property values * @input_fence_timeout_ns : Cached input fence timeout, in ns * @num_dim_layers: Number of dim layers * @cwb_enc_mask : encoder mask populated during atomic_check if CWB is enabled * @cached_cwb_enc_mask : cached encoder mask populated during atomic_check if CWB is enabled * @dim_layer: Dim layer configs * @num_ds: Number of destination scalers to be configured * @num_ds_enabled: Number of destination scalers enabled * @ds_cfg: Destination scaler config * @scl3_lut_cfg: QSEED3 lut config * @new_perf: new performance state being requested * @noise_layer_en: flag to indicate if noise layer cfg is valid * @drm_msm_noise_layer_cfg: noise layer configuration * @cp_prop_cnt: number of dirty color processing features * @cp_prop_values: array of cp property values * @cp_dirty_list: array tracking features that are dirty * @cp_range_payload: array storing state user_data passed via range props * @cont_splash_populated: State was populated as part of cont. splash * @param: sde line insertion parameters * @hwfence_in_fences_set: input hw fences are configured for the commit */ struct sde_crtc_state { struct drm_crtc_state base; struct drm_connector *connectors[MAX_CONNECTORS]; int num_connectors; struct sde_rsc_client *rsc_client; bool rsc_update; bool bw_control; bool bw_split_vote; bool is_ppsplit; struct sde_rect crtc_roi; struct sde_rect lm_bounds[MAX_MIXERS_PER_CRTC]; struct sde_rect lm_roi[MAX_MIXERS_PER_CRTC]; struct msm_roi_list user_roi_list, cached_user_roi_list; struct msm_property_state property_state; struct msm_property_value property_values[CRTC_PROP_COUNT]; DECLARE_BITMAP(dirty, SDE_CRTC_DIRTY_MAX); uint64_t input_fence_timeout_ns; uint32_t num_dim_layers; uint32_t cwb_enc_mask; uint32_t cached_cwb_enc_mask; struct sde_hw_dim_layer dim_layer[SDE_MAX_DIM_LAYERS]; uint32_t num_ds; uint32_t num_ds_enabled; struct sde_hw_ds_cfg ds_cfg[SDE_MAX_DS_COUNT]; struct sde_hw_scaler3_lut_cfg scl3_lut_cfg; struct sde_core_perf_params new_perf; bool noise_layer_en; struct drm_msm_noise_layer_cfg layer_cfg; uint32_t cp_prop_cnt; struct sde_cp_crtc_property_state cp_prop_values[SDE_CP_CRTC_MAX_FEATURES]; uint32_t cp_dirty_list[SDE_CP_CRTC_MAX_FEATURES]; struct sde_cp_crtc_range_prop_payload cp_range_payload[SDE_CP_CRTC_MAX_FEATURES]; bool cont_splash_populated; struct sde_line_insertion_param line_insertion; bool hwfence_in_fences_set; }; enum sde_crtc_irq_state { IRQ_NOINIT, IRQ_ENABLED, IRQ_DISABLING, IRQ_DISABLED, }; /** * sde_crtc_irq_info - crtc interrupt info * @irq: interrupt callback * @event: event type of the interrupt * @func: function pointer to enable/disable the interrupt * @list: list of user customized event in crtc * @state: state of the interrupt * @state_lock: spin lock for interrupt state */ struct sde_crtc_irq_info { struct sde_irq_callback irq; u32 event; int (*func)(struct drm_crtc *crtc, bool en, struct sde_irq_callback *irq); struct list_head list; enum sde_crtc_irq_state state; spinlock_t state_lock; }; #define to_sde_crtc_state(x) \ container_of(x, struct sde_crtc_state, base) /** * sde_crtc_get_property - query integer value of crtc property * @S: Pointer to crtc state * @X: Property index, from enum msm_mdp_crtc_property * Returns: Integer value of requested property */ #define sde_crtc_get_property(S, X) \ ((S) && ((X) < CRTC_PROP_COUNT) ? ((S)->property_values[(X)].value) : 0) /** * sde_crtc_frame_pending - retun the number of pending frames * @crtc: Pointer to drm crtc object */ static inline int sde_crtc_frame_pending(struct drm_crtc *crtc) { struct sde_crtc *sde_crtc; if (!crtc) return -EINVAL; sde_crtc = to_sde_crtc(crtc); return atomic_read(&sde_crtc->frame_pending); } /** * sde_crtc_set_needs_hw_reset - set hw reset flag, to handle reset during * commit kickoff * @crtc: Pointer to DRM crtc instance */ static inline void sde_crtc_set_needs_hw_reset(struct drm_crtc *crtc) { struct sde_crtc *sde_crtc; if (!crtc) return; sde_crtc = to_sde_crtc(crtc); sde_crtc->needs_hw_reset = true; } /** * sde_crtc_reset_hw - attempt hardware reset on errors * @crtc: Pointer to DRM crtc instance * @old_state: Pointer to crtc state for previous commit * @recovery_events: Whether or not recovery events are enabled * Returns: Zero if current commit should still be attempted */ int sde_crtc_reset_hw(struct drm_crtc *crtc, struct drm_crtc_state *old_state, bool recovery_events); /** * sde_crtc_dump_fences - dump info for input fences of each crtc plane * @crtc: Pointer to DRM crtc instance */ void sde_crtc_dump_fences(struct drm_crtc *crtc); /** * sde_crtc_is_fence_signaled - check if all fences have been signaled * @crtc: Pointer to DRM crtc instance * Returns: true if all fences are signaled, otherwise false. */ bool sde_crtc_is_fence_signaled(struct drm_crtc *crtc); /** * sde_crtc_request_frame_reset - requests for next frame reset * @crtc: Pointer to drm crtc object * @encoder: Pointer to drm encoder object */ static inline int sde_crtc_request_frame_reset(struct drm_crtc *crtc, struct drm_encoder *encoder) { struct sde_crtc *sde_crtc = to_sde_crtc(crtc); if (test_bit(HW_FENCE_IN_FENCES_ENABLE, sde_crtc->hwfence_features_mask)) sde_crtc_dump_fences(crtc); if (sde_crtc->frame_trigger_mode == FRAME_DONE_WAIT_POSTED_START || !sde_encoder_is_dsi_display(encoder)) sde_crtc_reset_hw(crtc, crtc->state, false); return 0; } /** * sde_crtc_get_mixer_resolution - Get the mixer resolution based on the features enabled. * Mixer width will be same as panel width(/2 for split) or src_width of * destination scaler or downscale-blur. * @drm_crtc: Pointer to drm crtc object * @crtc_state: Pointer to drm crtc state object * @mode: Pointer to drm display mode object * @width: Pointer to width object populated with mixer width by this function * @height: Pointer to height object populated with mixer height by this function */ void sde_crtc_get_mixer_resolution(struct drm_crtc *sde_crtc, struct drm_crtc_state *crtc_state, struct drm_display_mode *mode, u32 *width, u32 *height); /** * sde_crtc_get_resolution - Get the crtc resolution based on the features enabled. * Crtc width will be same as panel width or (src_width of * destination scaler or downscale-blur) * num_blocks. * @drm_crtc: Pointer to drm crtc object * @crtc_state: Pointer to drm crtc state object * @mode: Pointer to drm display mode object * @width: Pointer to width object populated with crtc width by this function * @height: Pointer to height object populated with crtc height by this function */ void sde_crtc_get_resolution(struct drm_crtc *sde_crtc, struct drm_crtc_state *crtc_state, struct drm_display_mode *mode, u32 *width, u32 *height); /** * sde_crtc_vblank - enable or disable vblanks for this crtc * @crtc: Pointer to drm crtc object * @en: true to enable vblanks, false to disable */ int sde_crtc_vblank(struct drm_crtc *crtc, bool en); /** * sde_crtc_get_msm_mode - get msm_mode for a given crtc state * @c_state: Pointer to drm crtc state object * Returns: msm_display_mode corresponding to this crtc state, or NULL if none */ struct msm_display_mode *sde_crtc_get_msm_mode(struct drm_crtc_state *c_state); /** * sde_crtc_commit_kickoff - trigger kickoff of the commit for this crtc * @crtc: Pointer to drm crtc object * @old_state: Pointer to drm crtc old state object */ void sde_crtc_commit_kickoff(struct drm_crtc *crtc, struct drm_crtc_state *old_state); /** * sde_crtc_prepare_commit - callback to prepare for output fences * @crtc: Pointer to drm crtc object * @old_state: Pointer to drm crtc old state object */ void sde_crtc_prepare_commit(struct drm_crtc *crtc, struct drm_crtc_state *old_state); /** * sde_crtc_complete_commit - callback signalling completion of current commit * @crtc: Pointer to drm crtc object * @old_state: Pointer to drm crtc old state object */ void sde_crtc_complete_commit(struct drm_crtc *crtc, struct drm_crtc_state *old_state); /** * sde_crtc_init - create a new crtc object * @dev: sde device * @plane: base plane * @Return: new crtc object or error */ struct drm_crtc *sde_crtc_init(struct drm_device *dev, struct drm_plane *plane); /** * sde_crtc_post_init - update crtc object with post initialization. It * can update the debugfs, sysfs, entires. * @dev: sde device * @crtc: Pointer to drm crtc structure */ int sde_crtc_post_init(struct drm_device *dev, struct drm_crtc *crtc); /** * sde_crtc_complete_flip - complete flip for clients * @crtc: Pointer to drm crtc object * @file: client to cancel's file handle */ void sde_crtc_complete_flip(struct drm_crtc *crtc, struct drm_file *file); /** * sde_crtc_register_custom_event - api for enabling/disabling crtc event * @kms: Pointer to sde_kms * @crtc_drm: Pointer to crtc object * @event: Event that client is interested * @en: Flag to enable/disable the event */ int sde_crtc_register_custom_event(struct sde_kms *kms, struct drm_crtc *crtc_drm, u32 event, bool en); /** * sde_crtc_get_intf_mode - get interface mode of the given crtc * @crtc: Pointert to DRM crtc * @crtc: Pointert to DRM crtc_state */ enum sde_intf_mode sde_crtc_get_intf_mode(struct drm_crtc *crtc, struct drm_crtc_state *cstate); /** * sde_crtc_get_fps_mode - get frame rate of the given crtc * @crtc: Pointert to crtc */ u32 sde_crtc_get_fps_mode(struct drm_crtc *crtc); /** * sde_crtc_get_dfps_maxfps - get DFPS max fps of the given crtc * @crtc: Pointert to crtc */ u32 sde_crtc_get_dfps_maxfps(struct drm_crtc *crtc); /** * sde_crtc_get_wb_usage_type - get writeback usage type * @crtc: Pointert to crtc */ enum sde_wb_usage_type sde_crtc_get_wb_usage_type(struct drm_crtc *crtc); /** * sde_crtc_get_client_type - check the crtc type- rt, rsc_rt, etc. * @crtc: Pointer to crtc */ static inline enum sde_crtc_client_type sde_crtc_get_client_type( struct drm_crtc *crtc) { struct sde_crtc_state *cstate = crtc ? to_sde_crtc_state(crtc->state) : NULL; if (!cstate) return RT_CLIENT; return cstate->rsc_client ? RT_RSC_CLIENT : RT_CLIENT; } /** * sde_crtc_is_rt_client - check if real-time client or not * @crtc: Pointer to DRM crtc * @crtc_state: Pointer to DRM crtc_state */ static inline bool sde_crtc_is_rt_client(struct drm_crtc *crtc, struct drm_crtc_state *cstate) { if (!crtc || !cstate) return true; return (sde_crtc_get_intf_mode(crtc, cstate) != INTF_MODE_WB_LINE); } /** * sde_crtc_is_enabled - check if sde crtc is enabled or not * @crtc: Pointer to crtc */ static inline bool sde_crtc_is_enabled(struct drm_crtc *crtc) { return crtc ? crtc->enabled : false; } static inline u32 sde_crtc_get_line_time(struct drm_crtc *crtc) { struct sde_crtc *sde_crtc; if (!crtc) return 0; sde_crtc = to_sde_crtc(crtc); return sde_crtc->line_time_in_ns; } /** * sde_crtc_is_reset_required - validate the reset request based on the * pm_suspend and crtc's active status. crtc's are left active * on pm_suspend during LP1/LP2 states, as the display is still * left ON. Avoid reset for the subsequent pm_resume in such cases. * @crtc: Pointer to crtc * return: false if in suspend state and crtc active, true otherwise */ static inline bool sde_crtc_is_reset_required(struct drm_crtc *crtc) { /* * reset is required even when there is no crtc_state as it is required * to create the initial state object */ if (!crtc || !crtc->state) return true; /* reset not required if crtc is active during suspend state */ if (sde_kms_is_suspend_state(crtc->dev) && crtc->state->active) return false; return true; } /** * sde_crtc_event_queue - request event callback * @crtc: Pointer to drm crtc structure * @func: Pointer to callback function * @usr: Pointer to user data to be passed to callback * @color_processing_event: True if color processing event * Returns: Zero on success */ int sde_crtc_event_queue(struct drm_crtc *crtc, void (*func)(struct drm_crtc *crtc, void *usr), void *usr, bool color_processing_event); /** * sde_crtc_get_crtc_roi - retrieve the crtc_roi from the given state object * used to allow the planes to adjust their final lm out_xy value in the * case of partial update * @crtc_state: Pointer to crtc state * @crtc_roi: Output pointer to crtc roi in the given state */ void sde_crtc_get_crtc_roi(struct drm_crtc_state *state, const struct sde_rect **crtc_roi); /** * sde_crtc_is_crtc_roi_dirty - retrieve whether crtc_roi was updated this frame * Note: Only use during atomic_check since dirty properties may be popped * @crtc_state: Pointer to crtc state * Return: true if roi is dirty, false otherwise */ bool sde_crtc_is_crtc_roi_dirty(struct drm_crtc_state *state); /** sde_crt_get_secure_level - retrieve the secure level from the give state * object, this is used to determine the secure state of the crtc * @crtc : Pointer to drm crtc structure * @usr: Pointer to drm crtc state * return: secure_level */ static inline int sde_crtc_get_secure_level(struct drm_crtc *crtc, struct drm_crtc_state *state) { if (!crtc || !state) return -EINVAL; return sde_crtc_get_property(to_sde_crtc_state(state), CRTC_PROP_SECURITY_LEVEL); } /** sde_crtc_atomic_check_has_modeset - checks if the new_crtc_state in the * drm_atomic_state has a modeset * @state : pointer to drm_atomic_state * @crtc : Pointer to drm crtc structure * Returns true if crtc has modeset */ static inline bool sde_crtc_atomic_check_has_modeset( struct drm_atomic_state *state, struct drm_crtc *crtc) { struct drm_crtc_state *crtc_state; if (!state || !crtc) return false; crtc_state = drm_atomic_get_new_crtc_state(state, crtc); return (crtc_state && drm_atomic_crtc_needs_modeset(crtc_state)); } static inline bool sde_crtc_state_in_clone_mode(struct drm_encoder *encoder, struct drm_crtc_state *state) { struct sde_crtc_state *cstate; if (!state || !encoder) return false; cstate = to_sde_crtc_state(state); if (sde_encoder_in_clone_mode(encoder) || (cstate->cwb_enc_mask & drm_encoder_mask(encoder))) return true; return false; } /** * sde_crtc_get_ds_io_res - populates the destination scaler src/dst w/h * @state: pointer to drm crtc state * @res: pointer to the output struct to populate the src/dst */ static inline void sde_crtc_get_ds_io_res(struct drm_crtc_state *state, struct sde_io_res *res) { struct sde_crtc_state *cstate; int i; if (!state || !res) return; cstate = to_sde_crtc_state(state); memset(res, 0, sizeof(struct sde_io_res)); for (i = 0; i < cstate->num_ds; i++) { if (cstate->ds_cfg[i].scl3_cfg.enable) { res->enabled = true; res->src_w += cstate->ds_cfg[i].lm_width; res->dst_w += cstate->ds_cfg[i].scl3_cfg.dst_width; res->src_h = cstate->ds_cfg[i].lm_height; res->dst_h = cstate->ds_cfg[i].scl3_cfg.dst_height; } } } /** * sde_crtc_get_secure_transition - determines the operations to be * performed before transitioning to secure state * This function should be called after swapping the new state * @crtc: Pointer to drm crtc structure * @old_crtc_state: Poniter to previous CRTC state * Returns the bitmask of operations need to be performed, -Error in * case of error cases */ int sde_crtc_get_secure_transition_ops(struct drm_crtc *crtc, struct drm_crtc_state *old_crtc_state, bool old_valid_fb); /** * sde_crtc_find_plane_fb_modes - finds the modes of all planes attached * to crtc * @crtc: Pointer to DRM crtc object * @fb_ns: number of non secure planes * @fb_sec: number of secure-playback planes * @fb_sec_dir: number of secure-ui/secure-camera planes */ int sde_crtc_find_plane_fb_modes(struct drm_crtc *crtc, uint32_t *fb_ns, uint32_t *fb_sec, uint32_t *fb_sec_dir); /** * sde_crtc_state_find_plane_fb_modes - finds the modes of all planes attached * to the crtc state * @crtc_state: Pointer to DRM crtc state object * @fb_ns: number of non secure planes * @fb_sec: number of secure-playback planes * @fb_sec_dir: number of secure-ui/secure-camera planes */ int sde_crtc_state_find_plane_fb_modes(struct drm_crtc_state *state, uint32_t *fb_ns, uint32_t *fb_sec, uint32_t *fb_sec_dir); /** * sde_crtc_secure_ctrl - Initiates the transition between secure and * non-secure world * @crtc: Pointer to crtc * @post_commit: if this operation is triggered after commit */ int sde_crtc_secure_ctrl(struct drm_crtc *crtc, bool post_commit); /** * sde_crtc_helper_reset_properties - reset properties to default values in the * given DRM CRTC state object * @crtc: Pointer to DRM crtc object * @crtc_state: Pointer to DRM crtc state object * Returns: 0 on success, negative errno on failure */ int sde_crtc_helper_reset_custom_properties(struct drm_crtc *crtc, struct drm_crtc_state *crtc_state); /** * sde_crtc_timeline_status - current buffer timeline status * @crtc: Pointer to crtc */ void sde_crtc_timeline_status(struct drm_crtc *crtc); /** * sde_crtc_update_cont_splash_settings - update mixer settings * during device bootup for cont_splash use case * @crtc: Pointer to drm crtc structure */ void sde_crtc_update_cont_splash_settings( struct drm_crtc *crtc); /** * sde_crtc_set_qos_dirty - update plane dirty flag to include * QoS reprogramming which is required during fps switch * @crtc: Pointer to drm crtc structure */ void sde_crtc_set_qos_dirty(struct drm_crtc *crtc); /** * sde_crtc_misr_setup - to configure and enable/disable MISR * @crtc: Pointer to drm crtc structure * @enable: boolean to indicate enable/disable misr * @frame_count: frame_count to be configured */ void sde_crtc_misr_setup(struct drm_crtc *crtc, bool enable, u32 frame_count); /** * sde_crtc_get_misr_info - to configure and enable/disable MISR * @crtc: Pointer to drm crtc structure * @crtc_misr_info: Pointer to crtc misr info structure */ void sde_crtc_get_misr_info(struct drm_crtc *crtc, struct sde_crtc_misr_info *crtc_misr_info); /** * sde_crtc_set_bpp - set src and target bpp values * @sde_crtc: Pointer to sde crtc struct * @src_bpp: source bpp value to be stored * @target_bpp: target value to be stored */ static inline void sde_crtc_set_bpp(struct sde_crtc *sde_crtc, int src_bpp, int target_bpp) { sde_crtc->src_bpp = src_bpp; sde_crtc->target_bpp = target_bpp; } /** * sde_crtc_static_img_control - transition static img cache state * @crtc: Pointer to drm crtc structure * @state: cache state to transition to * @is_vidmode: if encoder is video mode */ void sde_crtc_static_img_control(struct drm_crtc *crtc, enum sde_sys_cache_state state, bool is_vidmode); /** * sde_crtc_static_cache_read_kickoff - kickoff cache read work * @crtc: Pointer to drm crtc structure */ void sde_crtc_static_cache_read_kickoff(struct drm_crtc *crtc); /** * sde_crtc_get_num_datapath - get the number of datapath active * of primary connector * @crtc: Pointer to DRM crtc object * @connector: Pointer to DRM connector object of WB in CWB case * @crtc_state: Pointer to DRM crtc state */ int sde_crtc_get_num_datapath(struct drm_crtc *crtc, struct drm_connector *connector, struct drm_crtc_state *crtc_state); /** * sde_crtc_reset_sw_state - reset dirty proerties on crtc and * planes attached to the crtc * @crtc: Pointer to DRM crtc object */ void sde_crtc_reset_sw_state(struct drm_crtc *crtc); /** * sde_crtc_disable_cp_features - api to disable cp features that depend on planes being active. * Encoder disables the planes during suspend and calls this api for the crtc to disable * any features that require planes to be active * @crtc: Pointer to DRM crtc object */ void sde_crtc_disable_cp_features(struct drm_crtc *crtc); /* * _sde_crtc_clear_dim_layers_v1 - clear all dim layer settings * @cstate: Pointer to drm crtc state */ void _sde_crtc_clear_dim_layers_v1(struct drm_crtc_state *state); /** * sde_crtc_cancel_delayed_work - cancel any pending work items for a given crtc * @crtc: Pointer to DRM crtc object */ void sde_crtc_cancel_delayed_work(struct drm_crtc *crtc); /* * sde_crtc_get_src_encoder_of_clone- find source encoder of a clone mode encoder * @cstate: Pointer to DRM crtc object */ struct drm_encoder *sde_crtc_get_src_encoder_of_clone(struct drm_crtc *crtc); /* * _sde_crtc_vm_release_notify- send event to usermode on vm release */ void _sde_crtc_vm_release_notify(struct drm_crtc *crtc); /* * sde_crtc_is_line_insertion_supported - get lineinsertion * feature bit value from panel * @drm_crtc: Pointer to drm crtc structure * @Return: line insertion support status */ bool sde_crtc_is_line_insertion_supported(struct drm_crtc *crtc); /** * sde_crtc_calc_vpadding_param - calculate vpadding parameters * @state: Pointer to DRM crtc state object * @crtc_y: Plane's CRTC_Y offset * @crtc_h: Plane's CRTC_H size * @padding_y: Padding Y offset * @padding_start: Padding start offset * @padding_height: Padding height in total */ void sde_crtc_calc_vpadding_param(struct drm_crtc_state *state, u32 crtc_y, u32 crtc_h, u32 *padding_y, u32 *padding_start, u32 *padding_height); /** * sde_crtc_backlight_notify - notify backlight * @crtc: Pointer to drm_crtc. * @bl_val: Backlight value. * @bl_max: Max backlight value. */ void sde_crtc_backlight_notify(struct drm_crtc *crtc, u32 bl_val, u32 bl_max); #endif /* _SDE_CRTC_H_ */