include/uapi/drm/habanalabs_accel.h

File Facts

System

Linux kernel

Corpus path

include/uapi/drm/habanalabs_accel.h

Extension

.h

Size

81516 bytes

Lines

2369

Domain

Repository Root And Misc

Bucket

include

Inferred role

Repository Root And Misc: implementation source

Status

source implementation candidate

Why This File Exists

Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.

• Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• drm/drm.h

Detected Declarations

• struct hl_info_hw_ip_info
• struct hl_info_dram_usage
• struct hl_info_hw_idle
• struct hl_info_device_status
• struct hl_info_device_utilization
• struct hl_info_clk_rate
• struct hl_info_reset_count
• struct hl_info_time_sync
• struct hl_info_pci_counters
• struct hl_info_clk_throttle
• struct hl_info_energy
• struct hl_pll_frequency_info
• struct hl_open_stats_info
• struct hl_power_info
• struct hl_info_sync_manager
• struct hl_info_cs_counters
• struct hl_info_last_err_open_dev_time
• struct hl_info_cs_timeout_event
• struct hl_info_razwi_event
• struct hl_info_undefined_opcode_event
• struct hl_info_hw_err_event
• struct hl_info_fw_err_event
• struct hl_info_engine_err_event
• struct hl_info_dev_memalloc_page_sizes
• struct hl_info_sec_attest
• struct hl_info_signed
• struct hl_page_fault_info
• struct hl_user_mapping
• struct hl_info_args
• struct hl_cb_in
• struct hl_cb_out
• struct hl_cs_chunk
• struct hl_cs_in
• struct hl_cs_out
• struct hl_wait_cs_in
• struct hl_wait_cs_out
• struct hl_mem_in
• struct hl_mem_out
• struct hl_debug_params_etr
• struct hl_debug_params_etf
• struct hl_debug_params_stm
• struct hl_debug_params_bmon
• struct hl_debug_params_spmu
• struct hl_debug_args
• enum goya_queue_id
• enum gaudi_queue_id
• enum gaudi2_queue_id
• enum goya_engine_id

Annotated Snippet

struct hl_info_hw_ip_info {
	__u64 sram_base_address;
	__u64 dram_base_address;
	__u64 dram_size;
	__u32 sram_size;
	__u32 num_of_events;
	__u32 device_id;
	__u32 module_id;
	__u32 decoder_enabled_mask;
	__u16 first_available_interrupt_id;
	__u16 server_type;
	__u32 cpld_version;
	__u32 psoc_pci_pll_nr;
	__u32 psoc_pci_pll_nf;
	__u32 psoc_pci_pll_od;
	__u32 psoc_pci_pll_div_factor;
	__u8 tpc_enabled_mask;
	__u8 dram_enabled;
	__u8 security_enabled;
	__u8 mme_master_slave_mode;
	__u8 cpucp_version[HL_INFO_VERSION_MAX_LEN];
	__u8 card_name[HL_INFO_CARD_NAME_MAX_LEN];
	__u64 tpc_enabled_mask_ext;
	__u64 dram_page_size;
	__u32 edma_enabled_mask;
	__u16 number_of_user_interrupts;
	__u8 reserved1;
	__u8 reserved2;
	__u64 reserved3;
	__u64 device_mem_alloc_default_page_size;
	__u64 reserved4;
	__u64 reserved5;
	__u32 reserved6;
	__u8 reserved7;
	__u8 revision_id;
	__u16 tpc_interrupt_id;
	__u32 rotator_enabled_mask;
	__u32 reserved9;
	__u64 engine_core_interrupt_reg_addr;
	__u64 reserved_dram_size;
};

struct hl_info_dram_usage {
	__u64 dram_free_mem;
	__u64 ctx_dram_mem;
};

#define HL_BUSY_ENGINES_MASK_EXT_SIZE	4

struct hl_info_hw_idle {
	__u32 is_idle;
	/*
	 * Bitmask of busy engines.
	 * Bits definition is according to `enum <chip>_engine_id'.
	 */
	__u32 busy_engines_mask;

	/*
	 * Extended Bitmask of busy engines.
	 * Bits definition is according to `enum <chip>_engine_id'.
	 */
	__u64 busy_engines_mask_ext[HL_BUSY_ENGINES_MASK_EXT_SIZE];
};

struct hl_info_device_status {
	__u32 status;
	__u32 pad;
};

struct hl_info_device_utilization {
	__u32 utilization;
	__u32 pad;
};

struct hl_info_clk_rate {
	__u32 cur_clk_rate_mhz;
	__u32 max_clk_rate_mhz;
};

struct hl_info_reset_count {
	__u32 hard_reset_cnt;
	__u32 soft_reset_cnt;
};

struct hl_info_time_sync {
	__u64 device_time;
	__u64 host_time;
	__u64 tsc_time;
};

Annotation

• Immediate include surface: `drm/drm.h`.
• Detected declarations: `struct hl_info_hw_ip_info`, `struct hl_info_dram_usage`, `struct hl_info_hw_idle`, `struct hl_info_device_status`, `struct hl_info_device_utilization`, `struct hl_info_clk_rate`, `struct hl_info_reset_count`, `struct hl_info_time_sync`, `struct hl_info_pci_counters`, `struct hl_info_clk_throttle`.
• Atlas domain: Repository Root And Misc / include.
• 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.