drivers/gpu/drm/amd/amdgpu/ta_xgmi_if.h
Source file repositories/reference/linux-study-clean/drivers/gpu/drm/amd/amdgpu/ta_xgmi_if.h
File Facts
- System
- Linux kernel
- Corpus path
drivers/gpu/drm/amd/amdgpu/ta_xgmi_if.h- Extension
.h- Size
- 6004 bytes
- Lines
- 178
- 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
- No C-style include directives detected by the generator.
Detected Declarations
struct ta_xgmi_node_infostruct ta_xgmi_peer_link_infostruct xgmi_connected_port_numstruct ta_xgmi_extend_peer_link_infostruct ta_xgmi_cmd_initialize_outputstruct ta_xgmi_cmd_get_node_id_outputstruct ta_xgmi_cmd_get_hive_id_outputstruct ta_xgmi_cmd_get_topology_info_inputstruct ta_xgmi_cmd_get_topology_info_outputstruct ta_xgmi_cmd_set_topology_info_inputstruct ta_xgmi_cmd_get_peer_link_infostruct ta_xgmi_cmd_get_extend_peer_link_infostruct ta_xgmi_shared_memoryenum ta_command_xgmienum ta_xgmi_statusenum ta_xgmi_assigned_sdma_engine
Annotated Snippet
struct ta_xgmi_node_info {
uint64_t node_id;
uint8_t num_hops;
uint8_t is_sharing_enabled;
enum ta_xgmi_assigned_sdma_engine sdma_engine;
};
struct ta_xgmi_peer_link_info {
uint64_t node_id;
uint8_t num_links;
};
struct xgmi_connected_port_num {
uint8_t dst_xgmi_port_num;
uint8_t src_xgmi_port_num;
};
/* support both the port num and num_links */
struct ta_xgmi_extend_peer_link_info {
uint64_t node_id;
uint8_t num_links;
struct xgmi_connected_port_num port_num[TA_XGMI__MAX_PORT_NUM];
};
struct ta_xgmi_cmd_initialize_output {
uint32_t status;
};
struct ta_xgmi_cmd_get_node_id_output {
uint64_t node_id;
};
struct ta_xgmi_cmd_get_hive_id_output {
uint64_t hive_id;
};
struct ta_xgmi_cmd_get_topology_info_input {
uint32_t num_nodes;
struct ta_xgmi_node_info nodes[TA_XGMI__MAX_CONNECTED_NODES];
};
struct ta_xgmi_cmd_get_topology_info_output {
uint32_t num_nodes;
struct ta_xgmi_node_info nodes[TA_XGMI__MAX_CONNECTED_NODES];
};
struct ta_xgmi_cmd_set_topology_info_input {
uint32_t num_nodes;
struct ta_xgmi_node_info nodes[TA_XGMI__MAX_CONNECTED_NODES];
};
/* support XGMI TA w/ and w/o port_num both so two similar structs defined */
struct ta_xgmi_cmd_get_peer_link_info {
uint32_t num_nodes;
struct ta_xgmi_peer_link_info nodes[TA_XGMI__MAX_CONNECTED_NODES];
};
struct ta_xgmi_cmd_get_extend_peer_link_info {
uint32_t num_nodes;
struct ta_xgmi_extend_peer_link_info nodes[TA_XGMI__MAX_CONNECTED_NODES];
};
/**********************************************************/
/* Common input structure for XGMI callbacks */
union ta_xgmi_cmd_input {
struct ta_xgmi_cmd_get_topology_info_input get_topology_info;
struct ta_xgmi_cmd_set_topology_info_input set_topology_info;
};
/* Common output structure for XGMI callbacks */
union ta_xgmi_cmd_output {
struct ta_xgmi_cmd_initialize_output initialize;
struct ta_xgmi_cmd_get_node_id_output get_node_id;
struct ta_xgmi_cmd_get_hive_id_output get_hive_id;
struct ta_xgmi_cmd_get_topology_info_output get_topology_info;
struct ta_xgmi_cmd_get_peer_link_info get_link_info;
struct ta_xgmi_cmd_get_extend_peer_link_info get_extend_link_info;
};
struct ta_xgmi_shared_memory {
uint32_t cmd_id;
uint32_t resp_id;
enum ta_xgmi_status xgmi_status;
/* if the number of xgmi link record is more than 128, driver will set the
* flag 0 to get the first 128 of the link records and will set to 1, to get
* the second set
*/
uint8_t flag_extend_link_record;
/* bit0: port_num info support flag for GET_EXTEND_PEER_LINKS commmand */
uint8_t caps_flag;
Annotation
- Detected declarations: `struct ta_xgmi_node_info`, `struct ta_xgmi_peer_link_info`, `struct xgmi_connected_port_num`, `struct ta_xgmi_extend_peer_link_info`, `struct ta_xgmi_cmd_initialize_output`, `struct ta_xgmi_cmd_get_node_id_output`, `struct ta_xgmi_cmd_get_hive_id_output`, `struct ta_xgmi_cmd_get_topology_info_input`, `struct ta_xgmi_cmd_get_topology_info_output`, `struct ta_xgmi_cmd_set_topology_info_input`.
- 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.