STRUCT DPU_CRTC(9)

🦋 struct dpu_crtc 🦋

okay so bestie, this is the Kernel API Manual entry for struct dpu_crtc — the virtualized CRTC data structure. no cap, it's basically the main-character struct for a virtualized CRTC, and every field is about to get its little moment. 💅

🌸 NAME 🌸

struct dpu_crtc — virtualized CRTC data structure

✨ SYNOPSIS ✨

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;
    spinlock_t event_lock;
    struct dpu_core_perf_params cur_perf;
    struct dpu_crtc_smmu_state_data smmu_state;
 };

🫶 Members 🫶

• 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
• 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. It's updated in the commit-thread, not at state-swap time (which is earlier), so it's 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_lock — Spinlock around event handling code
• cur_perf — current performance committed to clock/bandwidth driver

👀 SEE ALSO 👀

go check these besties, iykyk:

• Kernel file ./drivers/gpu/drm/msm/disp/dpu1/dpu_crtc.h
• enum dpu_crtc_client_type(9)
• enum dpu_crtc_smmu_state(9)
• enum dpu_crtc_smmu_state_transition_type(9)
• struct dpu_crtc_smmu_state_data(9)
• enum dpu_crtc_crc_source(9)
• struct dpu_crtc_mixer(9)
• struct dpu_crtc_frame_event(9)
• struct dpu_crtc_state(9)
• dpu_crtc_frame_pending(9)
• dpu_crtc_get_client_type(9)

xoxo, bestie 💅 — source/version: ./drivers/gpu/drm/msm/disp/dpu1 · date: October 2026 🎀