| /* SPDX-License-Identifier: GPL-2.0-only */ |
| /* |
| * Copyright (c) 2015-2021 The Linux Foundation. All rights reserved. |
| * Copyright (C) 2013 Red Hat |
| * Author: Rob Clark <robdclark@gmail.com> |
| */ |
| |
| #ifndef _DPU_CRTC_H_ |
| #define _DPU_CRTC_H_ |
| |
| #include <linux/kthread.h> |
| #include <drm/drm_crtc.h> |
| #include "dpu_kms.h" |
| #include "dpu_core_perf.h" |
| #include "dpu_hw_blk.h" |
| |
| #define DPU_CRTC_NAME_SIZE 12 |
| |
| /* define the maximum number of in-flight frame events */ |
| #define DPU_CRTC_FRAME_EVENT_SIZE 4 |
| |
| /** |
| * enum dpu_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 |
| */ |
| enum dpu_crtc_client_type { |
| RT_CLIENT, |
| NRT_CLIENT, |
| }; |
| |
| /** |
| * enum dpu_crtc_smmu_state: smmu state |
| * @ATTACHED: all the context banks are attached. |
| * @DETACHED: all the context banks are detached. |
| * @ATTACH_ALL_REQ: transient state of attaching context banks. |
| * @DETACH_ALL_REQ: transient state of detaching context banks. |
| */ |
| enum dpu_crtc_smmu_state { |
| ATTACHED = 0, |
| DETACHED, |
| ATTACH_ALL_REQ, |
| DETACH_ALL_REQ, |
| }; |
| |
| /** |
| * enum dpu_crtc_smmu_state_transition_type: state transition type |
| * @NONE: no pending state transitions |
| * @PRE_COMMIT: state transitions should be done before processing the commit |
| * @POST_COMMIT: state transitions to be done after processing the commit. |
| */ |
| enum dpu_crtc_smmu_state_transition_type { |
| NONE, |
| PRE_COMMIT, |
| POST_COMMIT |
| }; |
| |
| /** |
| * struct dpu_crtc_smmu_state_data: stores the smmu state and transition type |
| * @state: current state of smmu context banks |
| * @transition_type: transition request type |
| * @transition_error: whether there is error while transitioning the state |
| */ |
| struct dpu_crtc_smmu_state_data { |
| uint32_t state; |
| uint32_t transition_type; |
| uint32_t transition_error; |
| }; |
| |
| /** |
| * enum dpu_crtc_crc_source: CRC source |
| * @DPU_CRTC_CRC_SOURCE_NONE: no source set |
| * @DPU_CRTC_CRC_SOURCE_LAYER_MIXER: CRC in layer mixer |
| * @DPU_CRTC_CRC_SOURCE_INVALID: Invalid source |
| */ |
| enum dpu_crtc_crc_source { |
| DPU_CRTC_CRC_SOURCE_NONE = 0, |
| DPU_CRTC_CRC_SOURCE_LAYER_MIXER, |
| DPU_CRTC_CRC_SOURCE_MAX, |
| DPU_CRTC_CRC_SOURCE_INVALID = -1 |
| }; |
| |
| /** |
| * struct dpu_crtc_mixer: stores the map for each virtual pipeline in the CRTC |
| * @hw_lm: LM HW Driver context |
| * @lm_ctl: CTL Path HW driver context |
| * @lm_dspp: DSPP HW driver context |
| * @mixer_op_mode: mixer blending operation mode |
| * @flush_mask: mixer flush mask for ctl, mixer and pipe |
| */ |
| struct dpu_crtc_mixer { |
| struct dpu_hw_mixer *hw_lm; |
| struct dpu_hw_ctl *lm_ctl; |
| struct dpu_hw_dspp *hw_dspp; |
| u32 mixer_op_mode; |
| u32 flush_mask; |
| }; |
| |
| /** |
| * struct dpu_crtc_frame_event: stores crtc frame event for crtc processing |
| * @work: base work structure |
| * @crtc: Pointer to crtc handling this event |
| * @list: event list |
| * @ts: timestamp at queue entry |
| * @event: event identifier |
| */ |
| struct dpu_crtc_frame_event { |
| struct kthread_work work; |
| struct drm_crtc *crtc; |
| struct list_head list; |
| ktime_t ts; |
| u32 event; |
| }; |
| |
| /* |
| * Maximum number of free event structures to cache |
| */ |
| #define DPU_CRTC_MAX_EVENT_COUNT 16 |
| |
| /** |
| * struct dpu_crtc - virtualized CRTC data structure |
| * @base : Base drm crtc structure |
| * @name : ASCII description of this crtc |
| * @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 |
| * @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 |
| * @enabled : whether the DPU 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 |
| * @feature_list : list of color processing features supported on a crtc |
| * @active_list : list of color processing features are active |
| * @dirty_list : list of color processing features are dirty |
| * @ad_dirty: list containing ad properties that are dirty |
| * @ad_active: list containing ad properties that are active |
| * @frame_pending : Whether or not an update is pending |
| * @frame_events : static allocation of in-flight frame events |
| * @frame_event_list : available frame event list |
| * @spin_lock : spin lock for frame event, transaction status, etc... |
| * @frame_done_comp : for frame_event_done synchronization |
| * @event_thread : Pointer to event handler thread |
| * @event_worker : Event worker queue |
| * @event_lock : Spinlock around event handling code |
| * @phandle: Pointer to power handler |
| * @cur_perf : current performance committed to clock/bandwidth driver |
| * @crc_source : CRC source |
| */ |
| struct dpu_crtc { |
| struct drm_crtc base; |
| char name[DPU_CRTC_NAME_SIZE]; |
| |
| struct drm_pending_vblank_event *event; |
| u32 vsync_count; |
| |
| u32 vblank_cb_count; |
| u64 play_count; |
| ktime_t vblank_cb_time; |
| bool enabled; |
| |
| struct list_head feature_list; |
| struct list_head active_list; |
| struct list_head dirty_list; |
| struct list_head ad_dirty; |
| struct list_head ad_active; |
| |
| atomic_t frame_pending; |
| struct dpu_crtc_frame_event frame_events[DPU_CRTC_FRAME_EVENT_SIZE]; |
| struct list_head frame_event_list; |
| spinlock_t spin_lock; |
| struct completion frame_done_comp; |
| |
| /* for handling internal event thread */ |
| spinlock_t event_lock; |
| |
| struct dpu_core_perf_params cur_perf; |
| |
| struct dpu_crtc_smmu_state_data smmu_state; |
| }; |
| |
| #define to_dpu_crtc(x) container_of(x, struct dpu_crtc, base) |
| |
| /** |
| * struct dpu_crtc_state - dpu container for atomic crtc state |
| * @base: Base drm crtc state structure |
| * @bw_control : true if bw/clk controlled by core bw/clk properties |
| * @bw_split_vote : true if bw controlled by llcc/dram bw properties |
| * @lm_bounds : LM boundaries based on current mode full resolution, no ROI. |
| * Origin top left of CRTC. |
| * @property_state: Local storage for msm_prop properties |
| * @property_values: Current crtc property values |
| * @input_fence_timeout_ns : Cached input fence timeout, in ns |
| * @new_perf: new performance state being requested |
| * @num_mixers : Number of mixers in use |
| * @mixers : List of active mixers |
| * @num_ctls : Number of ctl paths in use |
| * @hw_ctls : List of active ctl paths |
| */ |
| struct dpu_crtc_state { |
| struct drm_crtc_state base; |
| |
| bool bw_control; |
| bool bw_split_vote; |
| struct drm_rect lm_bounds[CRTC_DUAL_MIXERS]; |
| |
| uint64_t input_fence_timeout_ns; |
| |
| struct dpu_core_perf_params new_perf; |
| |
| /* HW Resources reserved for the crtc */ |
| u32 num_mixers; |
| struct dpu_crtc_mixer mixers[CRTC_DUAL_MIXERS]; |
| |
| u32 num_ctls; |
| struct dpu_hw_ctl *hw_ctls[CRTC_DUAL_MIXERS]; |
| |
| enum dpu_crtc_crc_source crc_source; |
| int crc_frame_skip_count; |
| }; |
| |
| #define to_dpu_crtc_state(x) \ |
| container_of(x, struct dpu_crtc_state, base) |
| |
| /** |
| * dpu_crtc_frame_pending - retun the number of pending frames |
| * @crtc: Pointer to drm crtc object |
| */ |
| static inline int dpu_crtc_frame_pending(struct drm_crtc *crtc) |
| { |
| return crtc ? atomic_read(&to_dpu_crtc(crtc)->frame_pending) : -EINVAL; |
| } |
| |
| /** |
| * dpu_crtc_vblank - enable or disable vblanks for this crtc |
| * @crtc: Pointer to drm crtc object |
| * @en: true to enable vblanks, false to disable |
| */ |
| int dpu_crtc_vblank(struct drm_crtc *crtc, bool en); |
| |
| /** |
| * dpu_crtc_vblank_callback - called on vblank irq, issues completion events |
| * @crtc: Pointer to drm crtc object |
| */ |
| void dpu_crtc_vblank_callback(struct drm_crtc *crtc); |
| |
| /** |
| * dpu_crtc_commit_kickoff - trigger kickoff of the commit for this crtc |
| * @crtc: Pointer to drm crtc object |
| */ |
| void dpu_crtc_commit_kickoff(struct drm_crtc *crtc); |
| |
| /** |
| * dpu_crtc_complete_commit - callback signalling completion of current commit |
| * @crtc: Pointer to drm crtc object |
| */ |
| void dpu_crtc_complete_commit(struct drm_crtc *crtc); |
| |
| /** |
| * dpu_crtc_init - create a new crtc object |
| * @dev: dpu device |
| * @plane: base plane |
| * @cursor: cursor plane |
| * @Return: new crtc object or error |
| */ |
| struct drm_crtc *dpu_crtc_init(struct drm_device *dev, struct drm_plane *plane, |
| struct drm_plane *cursor); |
| |
| /** |
| * dpu_crtc_register_custom_event - api for enabling/disabling crtc event |
| * @kms: Pointer to dpu_kms |
| * @crtc_drm: Pointer to crtc object |
| * @event: Event that client is interested |
| * @en: Flag to enable/disable the event |
| */ |
| int dpu_crtc_register_custom_event(struct dpu_kms *kms, |
| struct drm_crtc *crtc_drm, u32 event, bool en); |
| |
| /** |
| * dpu_crtc_get_intf_mode - get interface mode of the given crtc |
| * @crtc: Pointert to crtc |
| */ |
| enum dpu_intf_mode dpu_crtc_get_intf_mode(struct drm_crtc *crtc); |
| |
| /** |
| * dpu_crtc_get_client_type - check the crtc type- rt, nrt etc. |
| * @crtc: Pointer to crtc |
| */ |
| static inline enum dpu_crtc_client_type dpu_crtc_get_client_type( |
| struct drm_crtc *crtc) |
| { |
| return crtc && crtc->state ? RT_CLIENT : NRT_CLIENT; |
| } |
| |
| #endif /* _DPU_CRTC_H_ */ |
