1 /* SPDX-License-Identifier: GPL-2.0 OR MIT */
2 /*
3  * Copyright 2014-2022 Advanced Micro Devices, Inc.
4  *
5  * Permission is hereby granted, free of charge, to any person obtaining a
6  * copy of this software and associated documentation files (the "Software"),
7  * to deal in the Software without restriction, including without limitation
8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9  * and/or sell copies of the Software, and to permit persons to whom the
10  * Software is furnished to do so, subject to the following conditions:
11  *
12  * The above copyright notice and this permission notice shall be included in
13  * all copies or substantial portions of the Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
19  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
20  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
21  * OTHER DEALINGS IN THE SOFTWARE.
22  */
23 
24 #ifndef __KFD_TOPOLOGY_H__
25 #define __KFD_TOPOLOGY_H__
26 
27 #include <linux/types.h>
28 #include <linux/list.h>
29 #include <linux/kfd_sysfs.h>
30 #include "kfd_crat.h"
31 
32 #define KFD_TOPOLOGY_PUBLIC_NAME_SIZE 32
33 
34 #define HSA_DBG_WATCH_ADDR_MASK_LO_BIT_GFX9	6
35 #define HSA_DBG_WATCH_ADDR_MASK_LO_BIT_GFX10	7
36 #define HSA_DBG_WATCH_ADDR_MASK_HI_BIT  \
37 			(29 << HSA_DBG_WATCH_ADDR_MASK_HI_BIT_SHIFT)
38 
39 struct kfd_node_properties {
40 	uint64_t hive_id;
41 	uint32_t cpu_cores_count;
42 	uint32_t simd_count;
43 	uint32_t mem_banks_count;
44 	uint32_t caches_count;
45 	uint32_t io_links_count;
46 	uint32_t p2p_links_count;
47 	uint32_t cpu_core_id_base;
48 	uint32_t simd_id_base;
49 	uint32_t capability;
50 	uint64_t debug_prop;
51 	uint32_t max_waves_per_simd;
52 	uint32_t lds_size_in_kb;
53 	uint32_t gds_size_in_kb;
54 	uint32_t num_gws;
55 	uint32_t wave_front_size;
56 	uint32_t array_count;
57 	uint32_t simd_arrays_per_engine;
58 	uint32_t cu_per_simd_array;
59 	uint32_t simd_per_cu;
60 	uint32_t max_slots_scratch_cu;
61 	uint32_t engine_id;
62 	uint32_t gfx_target_version;
63 	uint32_t vendor_id;
64 	uint32_t device_id;
65 	uint32_t location_id;
66 	uint32_t domain;
67 	uint32_t max_engine_clk_fcompute;
68 	uint32_t max_engine_clk_ccompute;
69 	int32_t  drm_render_minor;
70 	uint32_t num_sdma_engines;
71 	uint32_t num_sdma_xgmi_engines;
72 	uint32_t num_sdma_queues_per_engine;
73 	uint32_t num_cp_queues;
74 	char name[KFD_TOPOLOGY_PUBLIC_NAME_SIZE];
75 };
76 
77 struct kfd_mem_properties {
78 	struct list_head	list;
79 	uint32_t		heap_type;
80 	uint64_t		size_in_bytes;
81 	uint32_t		flags;
82 	uint32_t		width;
83 	uint32_t		mem_clk_max;
84 	struct kfd_node		*gpu;
85 	struct kobject		*kobj;
86 	struct attribute	attr;
87 };
88 
89 #define CACHE_SIBLINGMAP_SIZE 64
90 
91 struct kfd_cache_properties {
92 	struct list_head	list;
93 	uint32_t		processor_id_low;
94 	uint32_t		cache_level;
95 	uint32_t		cache_size;
96 	uint32_t		cacheline_size;
97 	uint32_t		cachelines_per_tag;
98 	uint32_t		cache_assoc;
99 	uint32_t		cache_latency;
100 	uint32_t		cache_type;
101 	uint8_t			sibling_map[CACHE_SIBLINGMAP_SIZE];
102 	struct kfd_node		*gpu;
103 	struct kobject		*kobj;
104 	struct attribute	attr;
105 	uint32_t		sibling_map_size;
106 };
107 
108 struct kfd_iolink_properties {
109 	struct list_head	list;
110 	uint32_t		iolink_type;
111 	uint32_t		ver_maj;
112 	uint32_t		ver_min;
113 	uint32_t		node_from;
114 	uint32_t		node_to;
115 	uint32_t		weight;
116 	uint32_t		min_latency;
117 	uint32_t		max_latency;
118 	uint32_t		min_bandwidth;
119 	uint32_t		max_bandwidth;
120 	uint32_t		rec_transfer_size;
121 	uint32_t		flags;
122 	struct kfd_node		*gpu;
123 	struct kobject		*kobj;
124 	struct attribute	attr;
125 };
126 
127 struct kfd_perf_properties {
128 	struct list_head	list;
129 	char			block_name[16];
130 	uint32_t		max_concurrent;
131 	struct attribute_group	*attr_group;
132 };
133 
134 struct kfd_topology_device {
135 	struct list_head		list;
136 	uint32_t			gpu_id;
137 	uint32_t			proximity_domain;
138 	struct kfd_node_properties	node_props;
139 	struct list_head		mem_props;
140 	struct list_head		cache_props;
141 	struct list_head		io_link_props;
142 	struct list_head		p2p_link_props;
143 	struct list_head		perf_props;
144 	struct kfd_node			*gpu;
145 	struct kobject			*kobj_node;
146 	struct kobject			*kobj_mem;
147 	struct kobject			*kobj_cache;
148 	struct kobject			*kobj_iolink;
149 	struct kobject			*kobj_p2plink;
150 	struct kobject			*kobj_perf;
151 	struct attribute		attr_gpuid;
152 	struct attribute		attr_name;
153 	struct attribute		attr_props;
154 	uint8_t				oem_id[CRAT_OEMID_LENGTH];
155 	uint8_t				oem_table_id[CRAT_OEMTABLEID_LENGTH];
156 	uint32_t			oem_revision;
157 };
158 
159 struct kfd_system_properties {
160 	uint32_t		num_devices;     /* Number of H-NUMA nodes */
161 	uint32_t		generation_count;
162 	uint64_t		platform_oem;
163 	uint64_t		platform_id;
164 	uint64_t		platform_rev;
165 	struct kobject		*kobj_topology;
166 	struct kobject		*kobj_nodes;
167 	struct attribute	attr_genid;
168 	struct attribute	attr_props;
169 };
170 
171 struct kfd_topology_device *kfd_create_topology_device(
172 		struct list_head *device_list);
173 void kfd_release_topology_device_list(struct list_head *device_list);
174 
175 #endif /* __KFD_TOPOLOGY_H__ */
176