drivers/gpu/drm/msm/disp/dpu1/dpu_hw_mdss.h
Source file repositories/reference/linux-study-clean/drivers/gpu/drm/msm/disp/dpu1/dpu_hw_mdss.h
File Facts
- System
- Linux kernel
- Corpus path
drivers/gpu/drm/msm/disp/dpu1/dpu_hw_mdss.h- Extension
.h- Size
- 8569 bytes
- Lines
- 416
- Domain
- Driver Families
- Bucket
- drivers/gpu
- Inferred role
- Driver Families: implementation source
- Status
- source implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/kernel.hlinux/err.hmsm_drv.hdisp/mdp_format.h
Detected Declarations
struct dpu_hw_fmt_layoutstruct dpu_csc_cfgstruct dpu_mdss_colorstruct dpu_hw_tear_checkstruct dpu_hw_pp_vsync_infoenum dpu_vsync_sourceenum dpu_hw_blk_typeenum dpu_ssppenum dpu_sspp_typeenum dpu_lmenum dpu_stageenum dpu_dsppenum dpu_ctlenum dpu_dscenum dpu_cdmenum dpu_pingpongenum dpu_merge_3denum dpu_intfenum dpu_intf_typeenum dpu_intf_modeenum dpu_wbenum dpu_cwbenum dpu_wd_timerenum dpu_3d_blend_mode
Annotated Snippet
struct dpu_hw_fmt_layout {
uint32_t num_planes;
uint32_t width;
uint32_t height;
uint32_t total_size;
uint32_t plane_addr[DPU_MAX_PLANES];
uint32_t plane_size[DPU_MAX_PLANES];
uint32_t plane_pitch[DPU_MAX_PLANES];
};
struct dpu_csc_cfg {
/* matrix coefficients in S15.16 format */
uint32_t csc_mv[DPU_CSC_MATRIX_COEFF_SIZE];
uint32_t csc_pre_bv[DPU_CSC_BIAS_SIZE];
uint32_t csc_post_bv[DPU_CSC_BIAS_SIZE];
uint32_t csc_pre_lv[DPU_CSC_CLAMP_SIZE];
uint32_t csc_post_lv[DPU_CSC_CLAMP_SIZE];
};
/**
* struct dpu_mdss_color - mdss color description
* color 0 : green
* color 1 : blue
* color 2 : red
* color 3 : alpha
*/
struct dpu_mdss_color {
u32 color_0;
u32 color_1;
u32 color_2;
u32 color_3;
};
/*
* Define bit masks for h/w logging.
*/
#define DPU_DBG_MASK_NONE (1 << 0)
#define DPU_DBG_MASK_INTF (1 << 1)
#define DPU_DBG_MASK_LM (1 << 2)
#define DPU_DBG_MASK_CTL (1 << 3)
#define DPU_DBG_MASK_PINGPONG (1 << 4)
#define DPU_DBG_MASK_SSPP (1 << 5)
#define DPU_DBG_MASK_WB (1 << 6)
#define DPU_DBG_MASK_TOP (1 << 7)
#define DPU_DBG_MASK_VBIF (1 << 8)
#define DPU_DBG_MASK_ROT (1 << 9)
#define DPU_DBG_MASK_DSPP (1 << 10)
#define DPU_DBG_MASK_DSC (1 << 11)
#define DPU_DBG_MASK_CDM (1 << 12)
#define DPU_DBG_MASK_CWB (1 << 13)
/**
* struct dpu_hw_tear_check - Struct contains parameters to configure
* tear-effect module. This structure is used to configure tear-check
* logic present either in ping-pong or in interface module.
* @vsync_count: Ratio of MDP VSYNC clk freq(Hz) to refresh rate divided
* by no of lines
* @sync_cfg_height: Total vertical lines (display height - 1)
* @vsync_init_val: Init value to which the read pointer gets loaded at
* vsync edge
* @sync_threshold_start: Read pointer threshold start ROI for write operation
* @sync_threshold_continue: The minimum number of lines the write pointer
* needs to be above the read pointer
* @start_pos: The position from which the start_threshold value is added
* @rd_ptr_irq: The read pointer line at which interrupt has to be generated
* @hw_vsync_mode: Sync with external frame sync input
*/
struct dpu_hw_tear_check {
/*
* This is ratio of MDP VSYNC clk freq(Hz) to
* refresh rate divided by no of lines
*/
u32 vsync_count;
u32 sync_cfg_height;
u32 vsync_init_val;
u32 sync_threshold_start;
u32 sync_threshold_continue;
u32 start_pos;
u32 rd_ptr_irq;
u8 hw_vsync_mode;
};
/**
* struct dpu_hw_pp_vsync_info - Struct contains parameters to configure
* read and write pointers for command mode panels
* @rd_ptr_init_val: Value of rd pointer at vsync edge
* @rd_ptr_frame_count: Num frames sent since enabling interface
* @rd_ptr_line_count: Current line on panel (rd ptr)
* @wr_ptr_line_count: Current line within pp fifo (wr ptr)
* @intf_frame_count: Frames read from intf
Annotation
- Immediate include surface: `linux/kernel.h`, `linux/err.h`, `msm_drv.h`, `disp/mdp_format.h`.
- Detected declarations: `struct dpu_hw_fmt_layout`, `struct dpu_csc_cfg`, `struct dpu_mdss_color`, `struct dpu_hw_tear_check`, `struct dpu_hw_pp_vsync_info`, `enum dpu_vsync_source`, `enum dpu_hw_blk_type`, `enum dpu_sspp`, `enum dpu_sspp_type`, `enum dpu_lm`.
- Atlas domain: Driver Families / drivers/gpu.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.