1 /*
2  * Copyright 2022 Advanced Micro Devices, Inc.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice shall be included in
12  * all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
17  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
18  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20  * OTHER DEALINGS IN THE SOFTWARE.
21  *
22  */
23 
24 #ifndef AMDGPU_XCP_H
25 #define AMDGPU_XCP_H
26 
27 #include <linux/pci.h>
28 #include <linux/xarray.h>
29 
30 #include "amdgpu_ctx.h"
31 
32 #define MAX_XCP 8
33 
34 #define AMDGPU_XCP_MODE_NONE -1
35 #define AMDGPU_XCP_MODE_TRANS -2
36 
37 #define AMDGPU_XCP_FL_NONE 0
38 #define AMDGPU_XCP_FL_LOCKED (1 << 0)
39 
40 struct amdgpu_fpriv;
41 
42 enum AMDGPU_XCP_IP_BLOCK {
43 	AMDGPU_XCP_GFXHUB,
44 	AMDGPU_XCP_GFX,
45 	AMDGPU_XCP_SDMA,
46 	AMDGPU_XCP_VCN,
47 	AMDGPU_XCP_MAX_BLOCKS
48 };
49 
50 enum AMDGPU_XCP_STATE {
51 	AMDGPU_XCP_PREPARE_SUSPEND,
52 	AMDGPU_XCP_SUSPEND,
53 	AMDGPU_XCP_PREPARE_RESUME,
54 	AMDGPU_XCP_RESUME,
55 };
56 
57 struct amdgpu_xcp_ip_funcs {
58 	int (*prepare_suspend)(void *handle, uint32_t inst_mask);
59 	int (*suspend)(void *handle, uint32_t inst_mask);
60 	int (*prepare_resume)(void *handle, uint32_t inst_mask);
61 	int (*resume)(void *handle, uint32_t inst_mask);
62 };
63 
64 struct amdgpu_xcp_ip {
65 	struct amdgpu_xcp_ip_funcs *ip_funcs;
66 	uint32_t inst_mask;
67 
68 	enum AMDGPU_XCP_IP_BLOCK ip_id;
69 	bool valid;
70 };
71 
72 struct amdgpu_xcp {
73 	struct amdgpu_xcp_ip ip[AMDGPU_XCP_MAX_BLOCKS];
74 
75 	uint8_t id;
76 	uint8_t mem_id;
77 	bool valid;
78 	atomic_t	ref_cnt;
79 	struct drm_device *ddev;
80 	struct amdgpu_sched	gpu_sched[AMDGPU_HW_IP_NUM][AMDGPU_RING_PRIO_MAX];
81 };
82 
83 struct amdgpu_xcp_mgr {
84 	struct amdgpu_device *adev;
85 	struct mutex xcp_lock;
86 	struct amdgpu_xcp_mgr_funcs *funcs;
87 
88 	struct amdgpu_xcp xcp[MAX_XCP];
89 	uint8_t num_xcps;
90 	int8_t mode;
91 
92 	 /* Used to determine KFD memory size limits per XCP */
93 	unsigned int num_xcp_per_mem_partition;
94 };
95 
96 struct amdgpu_xcp_mgr_funcs {
97 	int (*switch_partition_mode)(struct amdgpu_xcp_mgr *xcp_mgr, int mode,
98 				     int *num_xcps);
99 	int (*query_partition_mode)(struct amdgpu_xcp_mgr *xcp_mgr);
100 	int (*get_ip_details)(struct amdgpu_xcp_mgr *xcp_mgr, int xcp_id,
101 			      enum AMDGPU_XCP_IP_BLOCK ip_id,
102 			      struct amdgpu_xcp_ip *ip);
103 	int (*get_xcp_mem_id)(struct amdgpu_xcp_mgr *xcp_mgr,
104 			      struct amdgpu_xcp *xcp, uint8_t *mem_id);
105 
106 	int (*prepare_suspend)(struct amdgpu_xcp_mgr *xcp_mgr, int xcp_id);
107 	int (*suspend)(struct amdgpu_xcp_mgr *xcp_mgr, int xcp_id);
108 	int (*prepare_resume)(struct amdgpu_xcp_mgr *xcp_mgr, int xcp_id);
109 	int (*resume)(struct amdgpu_xcp_mgr *xcp_mgr, int xcp_id);
110 	int (*select_scheds)(struct amdgpu_device *adev,
111 				  u32 hw_ip, u32 hw_prio, struct amdgpu_fpriv *fpriv,
112 				  unsigned int *num_scheds, struct drm_gpu_scheduler ***scheds);
113 	int (*update_partition_sched_list)(struct amdgpu_device *adev);
114 };
115 
116 int amdgpu_xcp_prepare_suspend(struct amdgpu_xcp_mgr *xcp_mgr, int xcp_id);
117 int amdgpu_xcp_suspend(struct amdgpu_xcp_mgr *xcp_mgr, int xcp_id);
118 int amdgpu_xcp_prepare_resume(struct amdgpu_xcp_mgr *xcp_mgr, int xcp_id);
119 int amdgpu_xcp_resume(struct amdgpu_xcp_mgr *xcp_mgr, int xcp_id);
120 
121 int amdgpu_xcp_mgr_init(struct amdgpu_device *adev, int init_mode,
122 			int init_xcps, struct amdgpu_xcp_mgr_funcs *xcp_funcs);
123 int amdgpu_xcp_init(struct amdgpu_xcp_mgr *xcp_mgr, int num_xcps, int mode);
124 int amdgpu_xcp_query_partition_mode(struct amdgpu_xcp_mgr *xcp_mgr, u32 flags);
125 int amdgpu_xcp_switch_partition_mode(struct amdgpu_xcp_mgr *xcp_mgr, int mode);
126 int amdgpu_xcp_get_partition(struct amdgpu_xcp_mgr *xcp_mgr,
127 			     enum AMDGPU_XCP_IP_BLOCK ip, int instance);
128 
129 int amdgpu_xcp_get_inst_details(struct amdgpu_xcp *xcp,
130 				enum AMDGPU_XCP_IP_BLOCK ip,
131 				uint32_t *inst_mask);
132 
133 int amdgpu_xcp_dev_register(struct amdgpu_device *adev,
134 				const struct pci_device_id *ent);
135 void amdgpu_xcp_dev_unplug(struct amdgpu_device *adev);
136 int amdgpu_xcp_open_device(struct amdgpu_device *adev,
137 			   struct amdgpu_fpriv *fpriv,
138 			   struct drm_file *file_priv);
139 void amdgpu_xcp_release_sched(struct amdgpu_device *adev,
140 			      struct amdgpu_ctx_entity *entity);
141 
142 #define amdgpu_xcp_select_scheds(adev, e, c, d, x, y) \
143 	((adev)->xcp_mgr && (adev)->xcp_mgr->funcs && \
144 	(adev)->xcp_mgr->funcs->select_scheds ? \
145 	(adev)->xcp_mgr->funcs->select_scheds((adev), (e), (c), (d), (x), (y)) : -ENOENT)
146 #define amdgpu_xcp_update_partition_sched_list(adev) \
147 	((adev)->xcp_mgr && (adev)->xcp_mgr->funcs && \
148 	(adev)->xcp_mgr->funcs->update_partition_sched_list ? \
149 	(adev)->xcp_mgr->funcs->update_partition_sched_list(adev) : 0)
150 
151 static inline int amdgpu_xcp_get_num_xcp(struct amdgpu_xcp_mgr *xcp_mgr)
152 {
153 	if (!xcp_mgr)
154 		return 1;
155 	else
156 		return xcp_mgr->num_xcps;
157 }
158 
159 static inline struct amdgpu_xcp *
160 amdgpu_get_next_xcp(struct amdgpu_xcp_mgr *xcp_mgr, int *from)
161 {
162 	if (!xcp_mgr)
163 		return NULL;
164 
165 	while (*from < MAX_XCP) {
166 		if (xcp_mgr->xcp[*from].valid)
167 			return &xcp_mgr->xcp[*from];
168 		++(*from);
169 	}
170 
171 	return NULL;
172 }
173 
174 #define for_each_xcp(xcp_mgr, xcp, i)                            \
175 	for (i = 0, xcp = amdgpu_get_next_xcp(xcp_mgr, &i); xcp; \
176 	     xcp = amdgpu_get_next_xcp(xcp_mgr, &i))
177 
178 #endif
179