drivers/gpu/drm/amd/display/dc/dc_hw_types.h

File Facts

System

Linux kernel

Corpus path

drivers/gpu/drm/amd/display/dc/dc_hw_types.h

Extension

.h

Size

32067 bytes

Lines

1254

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

• os_types.h
• fixed31_32.h
• signal_types.h

Detected Declarations

• struct dc_plane_address
• struct dc_size
• struct rect
• struct plane_size
• struct dc_plane_dcc_param
• struct dc_flip_addrs
• struct otc_pwa_frame_sync
• struct dc_tiling_info
• struct dc_cursor_position
• struct dc_cursor_mi_param
• struct dc_csc_transform
• struct dc_rgb_fixed
• struct dc_gamma
• struct dc_gamma_entries
• struct dc_cursor_attributes
• struct dpp_cursor_attributes
• struct scaling_taps
• struct dc_crtc_timing_flags
• struct dc_dsc_rc_params_override
• struct dc_dsc_config
• struct dc_crtc_timing
• struct crtc_trigger_info
• struct dc_crtc_timing_adjust
• struct mcif_warmup_params
• struct mcif_buf_params
• struct tg_color
• struct fva_adj
• struct phy_state
• struct cm_hist_control
• struct cm_hist
• enum dc_plane_addr_type
• enum surface_pixel_format
• enum dc_pixel_format
• enum tile_split_values
• enum tripleBuffer_enable
• enum tile_split_values_new
• enum otg_pwa_sync_mode
• enum array_mode_values
• enum tile_mode_values
• enum swizzle_mode_values
• enum swizzle_mode_addr3_values
• enum dc_gfxversion
• enum dc_rotation_angle
• enum dc_scan_direction
• enum dc_gamma_type
• enum dc_cursor_color_format
• enum dc_color_space
• enum dc_dither_option

Annotated Snippet

struct dc_plane_address {
	enum dc_plane_addr_type type;
	uint8_t tmz_surface;
	union {
		struct{
			PHYSICAL_ADDRESS_LOC addr;
			PHYSICAL_ADDRESS_LOC cursor_cache_addr;
			PHYSICAL_ADDRESS_LOC meta_addr;
			union large_integer dcc_const_color;
		} grph;

		struct {
			PHYSICAL_ADDRESS_LOC addr;
		} lut3d;

		/*stereo*/
		struct {
			PHYSICAL_ADDRESS_LOC left_addr;
			PHYSICAL_ADDRESS_LOC left_meta_addr;
			union large_integer left_dcc_const_color;

			PHYSICAL_ADDRESS_LOC right_addr;
			PHYSICAL_ADDRESS_LOC right_meta_addr;
			union large_integer right_dcc_const_color;

			PHYSICAL_ADDRESS_LOC left_alpha_addr;
			PHYSICAL_ADDRESS_LOC left_alpha_meta_addr;
			union large_integer left_alpha_dcc_const_color;

			PHYSICAL_ADDRESS_LOC right_alpha_addr;
			PHYSICAL_ADDRESS_LOC right_alpha_meta_addr;
			union large_integer right_alpha_dcc_const_color;
		} grph_stereo;

		/*video  progressive*/
		struct {
			PHYSICAL_ADDRESS_LOC luma_addr;
			PHYSICAL_ADDRESS_LOC luma_meta_addr;
			union large_integer luma_dcc_const_color;

			PHYSICAL_ADDRESS_LOC chroma_addr;
			PHYSICAL_ADDRESS_LOC chroma_meta_addr;
			union large_integer chroma_dcc_const_color;
		} video_progressive;

		struct {
			PHYSICAL_ADDRESS_LOC addr;
			PHYSICAL_ADDRESS_LOC meta_addr;
			union large_integer dcc_const_color;

			PHYSICAL_ADDRESS_LOC alpha_addr;
			PHYSICAL_ADDRESS_LOC alpha_meta_addr;
			union large_integer alpha_dcc_const_color;
		} rgbea;
	};

	union large_integer page_table_base;

	uint8_t vmid;
};

struct dc_size {
	int width;
	int height;
};

struct rect {
	int x;
	int y;
	int width;
	int height;
};

struct plane_size {
	/* Graphic surface pitch in pixels.
	 * In LINEAR_GENERAL mode, pitch
	 * is 32 pixel aligned.
	 */
	int surface_pitch;
	int chroma_pitch;
	struct rect surface_size;
	struct rect chroma_size;
};

struct dc_plane_dcc_param {
	bool enable;

	int meta_pitch;
	bool independent_64b_blks;
	uint8_t dcc_ind_blk;

Annotation

• Immediate include surface: `os_types.h`, `fixed31_32.h`, `signal_types.h`.
• Detected declarations: `struct dc_plane_address`, `struct dc_size`, `struct rect`, `struct plane_size`, `struct dc_plane_dcc_param`, `struct dc_flip_addrs`, `struct otc_pwa_frame_sync`, `struct dc_tiling_info`, `struct dc_cursor_position`, `struct dc_cursor_mi_param`.
• 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.