drivers/gpu/drm/amd/display/dc/inc/hw/abm.h

File Facts

System

Linux kernel

Corpus path

drivers/gpu/drm/amd/display/dc/inc/hw/abm.h

Extension

.h

Size

2568 bytes

Lines

72

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

• dm_services_types.h

Detected Declarations

• struct abm_save_restore
• struct abm
• struct abm_funcs

Annotated Snippet

struct abm {
	struct dc_context *ctx;
	const struct abm_funcs *funcs;
	bool dmcu_is_running;
};

struct abm_funcs {
	void (*abm_init)(struct abm *abm, uint32_t back_light, uint32_t user_level);
	bool (*set_abm_level)(struct abm *abm, unsigned int abm_level);
	bool (*set_abm_immediate_disable)(struct abm *abm, unsigned int panel_inst);
	bool (*set_pipe)(struct abm *abm, unsigned int controller_id, unsigned int panel_inst);

	/* backlight_pwm_u16_16 is unsigned 32 bit,
	 * 16 bit integer + 16 fractional, where 1.0 is max backlight value.
	 */
	bool (*set_backlight_level_pwm)(struct abm *abm,
			unsigned int backlight_pwm_u16_16,
			unsigned int frame_ramp,
			unsigned int controller_id,
			unsigned int panel_inst);

	unsigned int (*get_current_backlight)(struct abm *abm);
	unsigned int (*get_target_backlight)(struct abm *abm);
	bool (*init_abm_config)(struct abm *abm,
			const char *src,
			unsigned int bytes,
			unsigned int inst);
	bool (*set_abm_pause)(struct abm *abm, bool pause, unsigned int panel_inst, unsigned int otg_inst);
	bool (*save_restore)(
			struct abm *abm,
			unsigned int panel_inst,
			struct abm_save_restore *pData);
	bool (*set_pipe_ex)(struct abm *abm,
			unsigned int otg_inst,
			unsigned int option,
			unsigned int panel_inst,
			unsigned int pwrseq_inst);
};

#endif

Annotation

• Immediate include surface: `dm_services_types.h`.
• Detected declarations: `struct abm_save_restore`, `struct abm`, `struct abm_funcs`.
• 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.