Loading...
1/*
2 * Copyright 2017 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 _PSP_TEE_GFX_IF_H_
25#define _PSP_TEE_GFX_IF_H_
26
27#define PSP_GFX_CMD_BUF_VERSION 0x00000001
28
29#define GFX_CMD_STATUS_MASK 0x0000FFFF
30#define GFX_CMD_ID_MASK 0x000F0000
31#define GFX_CMD_RESERVED_MASK 0x7FF00000
32#define GFX_CMD_RESPONSE_MASK 0x80000000
33
34/* USBC PD FW version retrieval command */
35#define C2PMSG_CMD_GFX_USB_PD_FW_VER 0x2000000
36
37/* TEE Gfx Command IDs for the register interface.
38* Command ID must be between 0x00010000 and 0x000F0000.
39*/
40enum psp_gfx_crtl_cmd_id
41{
42 GFX_CTRL_CMD_ID_INIT_RBI_RING = 0x00010000, /* initialize RBI ring */
43 GFX_CTRL_CMD_ID_INIT_GPCOM_RING = 0x00020000, /* initialize GPCOM ring */
44 GFX_CTRL_CMD_ID_DESTROY_RINGS = 0x00030000, /* destroy rings */
45 GFX_CTRL_CMD_ID_CAN_INIT_RINGS = 0x00040000, /* is it allowed to initialized the rings */
46 GFX_CTRL_CMD_ID_ENABLE_INT = 0x00050000, /* enable PSP-to-Gfx interrupt */
47 GFX_CTRL_CMD_ID_DISABLE_INT = 0x00060000, /* disable PSP-to-Gfx interrupt */
48 GFX_CTRL_CMD_ID_MODE1_RST = 0x00070000, /* trigger the Mode 1 reset */
49 GFX_CTRL_CMD_ID_GBR_IH_SET = 0x00080000, /* set Gbr IH_RB_CNTL registers */
50 GFX_CTRL_CMD_ID_CONSUME_CMD = 0x00090000, /* send interrupt to psp for updating write pointer of vf */
51 GFX_CTRL_CMD_ID_DESTROY_GPCOM_RING = 0x000C0000, /* destroy GPCOM ring */
52
53 GFX_CTRL_CMD_ID_MAX = 0x000F0000, /* max command ID */
54};
55
56
57/*-----------------------------------------------------------------------------
58 NOTE: All physical addresses used in this interface are actually
59 GPU Virtual Addresses.
60*/
61
62
63/* Control registers of the TEE Gfx interface. These are located in
64* SRBM-to-PSP mailbox registers (total 8 registers).
65*/
66struct psp_gfx_ctrl
67{
68 volatile uint32_t cmd_resp; /* +0 Command/Response register for Gfx commands */
69 volatile uint32_t rbi_wptr; /* +4 Write pointer (index) of RBI ring */
70 volatile uint32_t rbi_rptr; /* +8 Read pointer (index) of RBI ring */
71 volatile uint32_t gpcom_wptr; /* +12 Write pointer (index) of GPCOM ring */
72 volatile uint32_t gpcom_rptr; /* +16 Read pointer (index) of GPCOM ring */
73 volatile uint32_t ring_addr_lo; /* +20 bits [31:0] of GPU Virtual of ring buffer (VMID=0)*/
74 volatile uint32_t ring_addr_hi; /* +24 bits [63:32] of GPU Virtual of ring buffer (VMID=0) */
75 volatile uint32_t ring_buf_size; /* +28 Ring buffer size (in bytes) */
76
77};
78
79
80/* Response flag is set in the command when command is completed by PSP.
81* Used in the GFX_CTRL.CmdResp.
82* When PSP GFX I/F is initialized, the flag is set.
83*/
84#define GFX_FLAG_RESPONSE 0x80000000
85
86/* TEE Gfx Command IDs for the ring buffer interface. */
87enum psp_gfx_cmd_id
88{
89 GFX_CMD_ID_LOAD_TA = 0x00000001, /* load TA */
90 GFX_CMD_ID_UNLOAD_TA = 0x00000002, /* unload TA */
91 GFX_CMD_ID_INVOKE_CMD = 0x00000003, /* send command to TA */
92 GFX_CMD_ID_LOAD_ASD = 0x00000004, /* load ASD Driver */
93 GFX_CMD_ID_SETUP_TMR = 0x00000005, /* setup TMR region */
94 GFX_CMD_ID_LOAD_IP_FW = 0x00000006, /* load HW IP FW */
95 GFX_CMD_ID_DESTROY_TMR = 0x00000007, /* destroy TMR region */
96 GFX_CMD_ID_SAVE_RESTORE = 0x00000008, /* save/restore HW IP FW */
97 GFX_CMD_ID_SETUP_VMR = 0x00000009, /* setup VMR region */
98 GFX_CMD_ID_DESTROY_VMR = 0x0000000A, /* destroy VMR region */
99 GFX_CMD_ID_PROG_REG = 0x0000000B, /* program regs */
100 GFX_CMD_ID_GET_FW_ATTESTATION = 0x0000000F, /* Query GPUVA of the Fw Attestation DB */
101 /* IDs upto 0x1F are reserved for older programs (Raven, Vega 10/12/20) */
102 GFX_CMD_ID_LOAD_TOC = 0x00000020, /* Load TOC and obtain TMR size */
103 GFX_CMD_ID_AUTOLOAD_RLC = 0x00000021, /* Indicates all graphics fw loaded, start RLC autoload */
104 GFX_CMD_ID_BOOT_CFG = 0x00000022, /* Boot Config */
105 GFX_CMD_ID_SRIOV_SPATIAL_PART = 0x00000027, /* Configure spatial partitioning mode */
106};
107
108/* PSP boot config sub-commands */
109enum psp_gfx_boot_config_cmd
110{
111 BOOTCFG_CMD_SET = 1, /* Set boot configuration settings */
112 BOOTCFG_CMD_GET = 2, /* Get boot configuration settings */
113 BOOTCFG_CMD_INVALIDATE = 3 /* Reset current boot configuration settings to VBIOS defaults */
114};
115
116/* PSP boot config bitmask values */
117enum psp_gfx_boot_config
118{
119 BOOT_CONFIG_GECC = 0x1,
120};
121
122/* Command to load Trusted Application binary into PSP OS. */
123struct psp_gfx_cmd_load_ta
124{
125 uint32_t app_phy_addr_lo; /* bits [31:0] of the GPU Virtual address of the TA binary (must be 4 KB aligned) */
126 uint32_t app_phy_addr_hi; /* bits [63:32] of the GPU Virtual address of the TA binary */
127 uint32_t app_len; /* length of the TA binary in bytes */
128 uint32_t cmd_buf_phy_addr_lo; /* bits [31:0] of the GPU Virtual address of CMD buffer (must be 4 KB aligned) */
129 uint32_t cmd_buf_phy_addr_hi; /* bits [63:32] of the GPU Virtual address of CMD buffer */
130 uint32_t cmd_buf_len; /* length of the CMD buffer in bytes; must be multiple of 4 KB */
131
132 /* Note: CmdBufLen can be set to 0. In this case no persistent CMD buffer is provided
133 * for the TA. Each InvokeCommand can have dinamically mapped CMD buffer instead
134 * of using global persistent buffer.
135 */
136};
137
138
139/* Command to Unload Trusted Application binary from PSP OS. */
140struct psp_gfx_cmd_unload_ta
141{
142 uint32_t session_id; /* Session ID of the loaded TA to be unloaded */
143
144};
145
146
147/* Shared buffers for InvokeCommand.
148*/
149struct psp_gfx_buf_desc
150{
151 uint32_t buf_phy_addr_lo; /* bits [31:0] of GPU Virtual address of the buffer (must be 4 KB aligned) */
152 uint32_t buf_phy_addr_hi; /* bits [63:32] of GPU Virtual address of the buffer */
153 uint32_t buf_size; /* buffer size in bytes (must be multiple of 4 KB and no bigger than 64 MB) */
154
155};
156
157/* Max number of descriptors for one shared buffer (in how many different
158* physical locations one shared buffer can be stored). If buffer is too much
159* fragmented, error will be returned.
160*/
161#define GFX_BUF_MAX_DESC 64
162
163struct psp_gfx_buf_list
164{
165 uint32_t num_desc; /* number of buffer descriptors in the list */
166 uint32_t total_size; /* total size of all buffers in the list in bytes (must be multiple of 4 KB) */
167 struct psp_gfx_buf_desc buf_desc[GFX_BUF_MAX_DESC]; /* list of buffer descriptors */
168
169 /* total 776 bytes */
170};
171
172/* Command to execute InvokeCommand entry point of the TA. */
173struct psp_gfx_cmd_invoke_cmd
174{
175 uint32_t session_id; /* Session ID of the TA to be executed */
176 uint32_t ta_cmd_id; /* Command ID to be sent to TA */
177 struct psp_gfx_buf_list buf; /* one indirect buffer (scatter/gather list) */
178
179};
180
181
182/* Command to setup TMR region. */
183struct psp_gfx_cmd_setup_tmr
184{
185 uint32_t buf_phy_addr_lo; /* bits [31:0] of GPU Virtual address of TMR buffer (must be 4 KB aligned) */
186 uint32_t buf_phy_addr_hi; /* bits [63:32] of GPU Virtual address of TMR buffer */
187 uint32_t buf_size; /* buffer size in bytes (must be multiple of 4 KB) */
188 union {
189 struct {
190 uint32_t sriov_enabled:1; /* whether the device runs under SR-IOV*/
191 uint32_t virt_phy_addr:1; /* driver passes both virtual and physical address to PSP*/
192 uint32_t reserved:30;
193 } bitfield;
194 uint32_t tmr_flags;
195 };
196 uint32_t system_phy_addr_lo; /* bits [31:0] of system physical address of TMR buffer (must be 4 KB aligned) */
197 uint32_t system_phy_addr_hi; /* bits [63:32] of system physical address of TMR buffer */
198
199};
200
201/* FW types for GFX_CMD_ID_LOAD_IP_FW command. Limit 31. */
202enum psp_gfx_fw_type {
203 GFX_FW_TYPE_NONE = 0, /* */
204 GFX_FW_TYPE_CP_ME = 1, /* CP-ME VG + RV */
205 GFX_FW_TYPE_CP_PFP = 2, /* CP-PFP VG + RV */
206 GFX_FW_TYPE_CP_CE = 3, /* CP-CE VG + RV */
207 GFX_FW_TYPE_CP_MEC = 4, /* CP-MEC FW VG + RV */
208 GFX_FW_TYPE_CP_MEC_ME1 = 5, /* CP-MEC Jump Table 1 VG + RV */
209 GFX_FW_TYPE_CP_MEC_ME2 = 6, /* CP-MEC Jump Table 2 VG */
210 GFX_FW_TYPE_RLC_V = 7, /* RLC-V VG */
211 GFX_FW_TYPE_RLC_G = 8, /* RLC-G VG + RV */
212 GFX_FW_TYPE_SDMA0 = 9, /* SDMA0 VG + RV */
213 GFX_FW_TYPE_SDMA1 = 10, /* SDMA1 VG */
214 GFX_FW_TYPE_DMCU_ERAM = 11, /* DMCU-ERAM VG + RV */
215 GFX_FW_TYPE_DMCU_ISR = 12, /* DMCU-ISR VG + RV */
216 GFX_FW_TYPE_VCN = 13, /* VCN RV */
217 GFX_FW_TYPE_UVD = 14, /* UVD VG */
218 GFX_FW_TYPE_VCE = 15, /* VCE VG */
219 GFX_FW_TYPE_ISP = 16, /* ISP RV */
220 GFX_FW_TYPE_ACP = 17, /* ACP RV */
221 GFX_FW_TYPE_SMU = 18, /* SMU VG */
222 GFX_FW_TYPE_MMSCH = 19, /* MMSCH VG */
223 GFX_FW_TYPE_RLC_RESTORE_LIST_GPM_MEM = 20, /* RLC GPM VG + RV */
224 GFX_FW_TYPE_RLC_RESTORE_LIST_SRM_MEM = 21, /* RLC SRM VG + RV */
225 GFX_FW_TYPE_RLC_RESTORE_LIST_SRM_CNTL = 22, /* RLC CNTL VG + RV */
226 GFX_FW_TYPE_UVD1 = 23, /* UVD1 VG-20 */
227 GFX_FW_TYPE_TOC = 24, /* TOC NV-10 */
228 GFX_FW_TYPE_RLC_P = 25, /* RLC P NV */
229 GFX_FW_TYPE_RLC_IRAM = 26, /* RLC_IRAM NV */
230 GFX_FW_TYPE_GLOBAL_TAP_DELAYS = 27, /* GLOBAL TAP DELAYS NV */
231 GFX_FW_TYPE_SE0_TAP_DELAYS = 28, /* SE0 TAP DELAYS NV */
232 GFX_FW_TYPE_SE1_TAP_DELAYS = 29, /* SE1 TAP DELAYS NV */
233 GFX_FW_TYPE_GLOBAL_SE0_SE1_SKEW_DELAYS = 30, /* GLOBAL SE0/1 SKEW DELAYS NV */
234 GFX_FW_TYPE_SDMA0_JT = 31, /* SDMA0 JT NV */
235 GFX_FW_TYPE_SDMA1_JT = 32, /* SDNA1 JT NV */
236 GFX_FW_TYPE_CP_MES = 33, /* CP MES NV */
237 GFX_FW_TYPE_MES_STACK = 34, /* MES STACK NV */
238 GFX_FW_TYPE_RLC_SRM_DRAM_SR = 35, /* RLC SRM DRAM NV */
239 GFX_FW_TYPE_RLCG_SCRATCH_SR = 36, /* RLCG SCRATCH NV */
240 GFX_FW_TYPE_RLCP_SCRATCH_SR = 37, /* RLCP SCRATCH NV */
241 GFX_FW_TYPE_RLCV_SCRATCH_SR = 38, /* RLCV SCRATCH NV */
242 GFX_FW_TYPE_RLX6_DRAM_SR = 39, /* RLX6 DRAM NV */
243 GFX_FW_TYPE_SDMA0_PG_CONTEXT = 40, /* SDMA0 PG CONTEXT NV */
244 GFX_FW_TYPE_SDMA1_PG_CONTEXT = 41, /* SDMA1 PG CONTEXT NV */
245 GFX_FW_TYPE_GLOBAL_MUX_SELECT_RAM = 42, /* GLOBAL MUX SEL RAM NV */
246 GFX_FW_TYPE_SE0_MUX_SELECT_RAM = 43, /* SE0 MUX SEL RAM NV */
247 GFX_FW_TYPE_SE1_MUX_SELECT_RAM = 44, /* SE1 MUX SEL RAM NV */
248 GFX_FW_TYPE_ACCUM_CTRL_RAM = 45, /* ACCUM CTRL RAM NV */
249 GFX_FW_TYPE_RLCP_CAM = 46, /* RLCP CAM NV */
250 GFX_FW_TYPE_RLC_SPP_CAM_EXT = 47, /* RLC SPP CAM EXT NV */
251 GFX_FW_TYPE_RLC_DRAM_BOOT = 48, /* RLC DRAM BOOT NV */
252 GFX_FW_TYPE_VCN0_RAM = 49, /* VCN_RAM NV + RN */
253 GFX_FW_TYPE_VCN1_RAM = 50, /* VCN_RAM NV + RN */
254 GFX_FW_TYPE_DMUB = 51, /* DMUB RN */
255 GFX_FW_TYPE_SDMA2 = 52, /* SDMA2 MI */
256 GFX_FW_TYPE_SDMA3 = 53, /* SDMA3 MI */
257 GFX_FW_TYPE_SDMA4 = 54, /* SDMA4 MI */
258 GFX_FW_TYPE_SDMA5 = 55, /* SDMA5 MI */
259 GFX_FW_TYPE_SDMA6 = 56, /* SDMA6 MI */
260 GFX_FW_TYPE_SDMA7 = 57, /* SDMA7 MI */
261 GFX_FW_TYPE_VCN1 = 58, /* VCN1 MI */
262 GFX_FW_TYPE_CAP = 62, /* CAP_FW */
263 GFX_FW_TYPE_SE2_TAP_DELAYS = 65, /* SE2 TAP DELAYS NV */
264 GFX_FW_TYPE_SE3_TAP_DELAYS = 66, /* SE3 TAP DELAYS NV */
265 GFX_FW_TYPE_REG_LIST = 67, /* REG_LIST MI */
266 GFX_FW_TYPE_IMU_I = 68, /* IMU Instruction FW SOC21 */
267 GFX_FW_TYPE_IMU_D = 69, /* IMU Data FW SOC21 */
268 GFX_FW_TYPE_LSDMA = 70, /* LSDMA FW SOC21 */
269 GFX_FW_TYPE_SDMA_UCODE_TH0 = 71, /* SDMA Thread 0/CTX SOC21 */
270 GFX_FW_TYPE_SDMA_UCODE_TH1 = 72, /* SDMA Thread 1/CTL SOC21 */
271 GFX_FW_TYPE_PPTABLE = 73, /* PPTABLE SOC21 */
272 GFX_FW_TYPE_DISCRETE_USB4 = 74, /* dUSB4 FW SOC21 */
273 GFX_FW_TYPE_TA = 75, /* SRIOV TA FW UUID SOC21 */
274 GFX_FW_TYPE_RS64_MES = 76, /* RS64 MES ucode SOC21 */
275 GFX_FW_TYPE_RS64_MES_STACK = 77, /* RS64 MES stack ucode SOC21 */
276 GFX_FW_TYPE_RS64_KIQ = 78, /* RS64 KIQ ucode SOC21 */
277 GFX_FW_TYPE_RS64_KIQ_STACK = 79, /* RS64 KIQ Heap stack SOC21 */
278 GFX_FW_TYPE_ISP_DATA = 80, /* ISP DATA SOC21 */
279 GFX_FW_TYPE_CP_MES_KIQ = 81, /* MES KIQ ucode SOC21 */
280 GFX_FW_TYPE_MES_KIQ_STACK = 82, /* MES KIQ stack SOC21 */
281 GFX_FW_TYPE_UMSCH_DATA = 83, /* User Mode Scheduler Data SOC21 */
282 GFX_FW_TYPE_UMSCH_UCODE = 84, /* User Mode Scheduler Ucode SOC21 */
283 GFX_FW_TYPE_UMSCH_CMD_BUFFER = 85, /* User Mode Scheduler Command Buffer SOC21 */
284 GFX_FW_TYPE_USB_DP_COMBO_PHY = 86, /* USB-Display port Combo SOC21 */
285 GFX_FW_TYPE_RS64_PFP = 87, /* RS64 PFP SOC21 */
286 GFX_FW_TYPE_RS64_ME = 88, /* RS64 ME SOC21 */
287 GFX_FW_TYPE_RS64_MEC = 89, /* RS64 MEC SOC21 */
288 GFX_FW_TYPE_RS64_PFP_P0_STACK = 90, /* RS64 PFP stack P0 SOC21 */
289 GFX_FW_TYPE_RS64_PFP_P1_STACK = 91, /* RS64 PFP stack P1 SOC21 */
290 GFX_FW_TYPE_RS64_ME_P0_STACK = 92, /* RS64 ME stack P0 SOC21 */
291 GFX_FW_TYPE_RS64_ME_P1_STACK = 93, /* RS64 ME stack P1 SOC21 */
292 GFX_FW_TYPE_RS64_MEC_P0_STACK = 94, /* RS64 MEC stack P0 SOC21 */
293 GFX_FW_TYPE_RS64_MEC_P1_STACK = 95, /* RS64 MEC stack P1 SOC21 */
294 GFX_FW_TYPE_RS64_MEC_P2_STACK = 96, /* RS64 MEC stack P2 SOC21 */
295 GFX_FW_TYPE_RS64_MEC_P3_STACK = 97, /* RS64 MEC stack P3 SOC21 */
296 GFX_FW_TYPE_VPEC_FW1 = 100, /* VPEC FW1 To Save VPE */
297 GFX_FW_TYPE_VPEC_FW2 = 101, /* VPEC FW2 To Save VPE */
298 GFX_FW_TYPE_VPE = 102,
299 GFX_FW_TYPE_JPEG_RAM = 128, /**< JPEG Command buffer */
300 GFX_FW_TYPE_P2S_TABLE = 129,
301 GFX_FW_TYPE_MAX
302};
303
304/* Command to load HW IP FW. */
305struct psp_gfx_cmd_load_ip_fw
306{
307 uint32_t fw_phy_addr_lo; /* bits [31:0] of GPU Virtual address of FW location (must be 4 KB aligned) */
308 uint32_t fw_phy_addr_hi; /* bits [63:32] of GPU Virtual address of FW location */
309 uint32_t fw_size; /* FW buffer size in bytes */
310 enum psp_gfx_fw_type fw_type; /* FW type */
311
312};
313
314/* Command to save/restore HW IP FW. */
315struct psp_gfx_cmd_save_restore_ip_fw
316{
317 uint32_t save_fw; /* if set, command is used for saving fw otherwise for resetoring*/
318 uint32_t save_restore_addr_lo; /* bits [31:0] of FB address of GART memory used as save/restore buffer (must be 4 KB aligned) */
319 uint32_t save_restore_addr_hi; /* bits [63:32] of FB address of GART memory used as save/restore buffer */
320 uint32_t buf_size; /* Size of the save/restore buffer in bytes */
321 enum psp_gfx_fw_type fw_type; /* FW type */
322};
323
324/* Command to setup register program */
325struct psp_gfx_cmd_reg_prog {
326 uint32_t reg_value;
327 uint32_t reg_id;
328};
329
330/* Command to load TOC */
331struct psp_gfx_cmd_load_toc
332{
333 uint32_t toc_phy_addr_lo; /* bits [31:0] of GPU Virtual address of FW location (must be 4 KB aligned) */
334 uint32_t toc_phy_addr_hi; /* bits [63:32] of GPU Virtual address of FW location */
335 uint32_t toc_size; /* FW buffer size in bytes */
336};
337
338/* Dynamic boot configuration */
339struct psp_gfx_cmd_boot_cfg
340{
341 uint32_t timestamp; /* calendar time as number of seconds */
342 enum psp_gfx_boot_config_cmd sub_cmd; /* sub-command indicating how to process command data */
343 uint32_t boot_config; /* dynamic boot configuration bitmask */
344 uint32_t boot_config_valid; /* dynamic boot configuration valid bits bitmask */
345};
346
347struct psp_gfx_cmd_sriov_spatial_part {
348 uint32_t mode;
349 uint32_t override_ips;
350 uint32_t override_xcds_avail;
351 uint32_t override_this_aid;
352};
353
354/* All GFX ring buffer commands. */
355union psp_gfx_commands
356{
357 struct psp_gfx_cmd_load_ta cmd_load_ta;
358 struct psp_gfx_cmd_unload_ta cmd_unload_ta;
359 struct psp_gfx_cmd_invoke_cmd cmd_invoke_cmd;
360 struct psp_gfx_cmd_setup_tmr cmd_setup_tmr;
361 struct psp_gfx_cmd_load_ip_fw cmd_load_ip_fw;
362 struct psp_gfx_cmd_save_restore_ip_fw cmd_save_restore_ip_fw;
363 struct psp_gfx_cmd_reg_prog cmd_setup_reg_prog;
364 struct psp_gfx_cmd_setup_tmr cmd_setup_vmr;
365 struct psp_gfx_cmd_load_toc cmd_load_toc;
366 struct psp_gfx_cmd_boot_cfg boot_cfg;
367 struct psp_gfx_cmd_sriov_spatial_part cmd_spatial_part;
368};
369
370struct psp_gfx_uresp_reserved
371{
372 uint32_t reserved[8];
373};
374
375/* Command-specific response for Fw Attestation Db */
376struct psp_gfx_uresp_fwar_db_info
377{
378 uint32_t fwar_db_addr_lo;
379 uint32_t fwar_db_addr_hi;
380};
381
382/* Command-specific response for boot config. */
383struct psp_gfx_uresp_bootcfg {
384 uint32_t boot_cfg; /* boot config data */
385};
386
387/* Union of command-specific responses for GPCOM ring. */
388union psp_gfx_uresp {
389 struct psp_gfx_uresp_reserved reserved;
390 struct psp_gfx_uresp_bootcfg boot_cfg;
391 struct psp_gfx_uresp_fwar_db_info fwar_db_info;
392};
393
394/* Structure of GFX Response buffer.
395* For GPCOM I/F it is part of GFX_CMD_RESP buffer, for RBI
396* it is separate buffer.
397*/
398struct psp_gfx_resp
399{
400 uint32_t status; /* +0 status of command execution */
401 uint32_t session_id; /* +4 session ID in response to LoadTa command */
402 uint32_t fw_addr_lo; /* +8 bits [31:0] of FW address within TMR (in response to cmd_load_ip_fw command) */
403 uint32_t fw_addr_hi; /* +12 bits [63:32] of FW address within TMR (in response to cmd_load_ip_fw command) */
404 uint32_t tmr_size; /* +16 size of the TMR to be reserved including MM fw and Gfx fw in response to cmd_load_toc command */
405
406 uint32_t reserved[11];
407
408 union psp_gfx_uresp uresp; /* +64 response union containing command-specific responses */
409
410 /* total 96 bytes */
411};
412
413/* Structure of Command buffer pointed by psp_gfx_rb_frame.cmd_buf_addr_hi
414* and psp_gfx_rb_frame.cmd_buf_addr_lo.
415*/
416struct psp_gfx_cmd_resp
417{
418 uint32_t buf_size; /* +0 total size of the buffer in bytes */
419 uint32_t buf_version; /* +4 version of the buffer strusture; must be PSP_GFX_CMD_BUF_VERSION */
420 uint32_t cmd_id; /* +8 command ID */
421
422 /* These fields are used for RBI only. They are all 0 in GPCOM commands
423 */
424 uint32_t resp_buf_addr_lo; /* +12 bits [31:0] of GPU Virtual address of response buffer (must be 4 KB aligned) */
425 uint32_t resp_buf_addr_hi; /* +16 bits [63:32] of GPU Virtual address of response buffer */
426 uint32_t resp_offset; /* +20 offset within response buffer */
427 uint32_t resp_buf_size; /* +24 total size of the response buffer in bytes */
428
429 union psp_gfx_commands cmd; /* +28 command specific structures */
430
431 uint8_t reserved_1[864 - sizeof(union psp_gfx_commands) - 28];
432
433 /* Note: Resp is part of this buffer for GPCOM ring. For RBI ring the response
434 * is separate buffer pointed by resp_buf_addr_hi and resp_buf_addr_lo.
435 */
436 struct psp_gfx_resp resp; /* +864 response */
437
438 uint8_t reserved_2[1024 - 864 - sizeof(struct psp_gfx_resp)];
439
440 /* total size 1024 bytes */
441};
442
443
444#define FRAME_TYPE_DESTROY 1 /* frame sent by KMD driver when UMD Scheduler context is destroyed*/
445
446/* Structure of the Ring Buffer Frame */
447struct psp_gfx_rb_frame
448{
449 uint32_t cmd_buf_addr_lo; /* +0 bits [31:0] of GPU Virtual address of command buffer (must be 4 KB aligned) */
450 uint32_t cmd_buf_addr_hi; /* +4 bits [63:32] of GPU Virtual address of command buffer */
451 uint32_t cmd_buf_size; /* +8 command buffer size in bytes */
452 uint32_t fence_addr_lo; /* +12 bits [31:0] of GPU Virtual address of Fence for this frame */
453 uint32_t fence_addr_hi; /* +16 bits [63:32] of GPU Virtual address of Fence for this frame */
454 uint32_t fence_value; /* +20 Fence value */
455 uint32_t sid_lo; /* +24 bits [31:0] of SID value (used only for RBI frames) */
456 uint32_t sid_hi; /* +28 bits [63:32] of SID value (used only for RBI frames) */
457 uint8_t vmid; /* +32 VMID value used for mapping of all addresses for this frame */
458 uint8_t frame_type; /* +33 1: destory context frame, 0: all other frames; used only for RBI frames */
459 uint8_t reserved1[2]; /* +34 reserved, must be 0 */
460 uint32_t reserved2[7]; /* +36 reserved, must be 0 */
461 /* total 64 bytes */
462};
463
464#define PSP_ERR_UNKNOWN_COMMAND 0x00000100
465
466enum tee_error_code {
467 TEE_SUCCESS = 0x00000000,
468 TEE_ERROR_NOT_SUPPORTED = 0xFFFF000A,
469};
470
471#endif /* _PSP_TEE_GFX_IF_H_ */
1/*
2 * Copyright 2017 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 _PSP_TEE_GFX_IF_H_
25#define _PSP_TEE_GFX_IF_H_
26
27#define PSP_GFX_CMD_BUF_VERSION 0x00000001
28
29#define GFX_CMD_STATUS_MASK 0x0000FFFF
30#define GFX_CMD_ID_MASK 0x000F0000
31#define GFX_CMD_RESERVED_MASK 0x7FF00000
32#define GFX_CMD_RESPONSE_MASK 0x80000000
33
34/* USBC PD FW version retrieval command */
35#define C2PMSG_CMD_GFX_USB_PD_FW_VER 0x2000000
36
37/* TEE Gfx Command IDs for the register interface.
38* Command ID must be between 0x00010000 and 0x000F0000.
39*/
40enum psp_gfx_crtl_cmd_id
41{
42 GFX_CTRL_CMD_ID_INIT_RBI_RING = 0x00010000, /* initialize RBI ring */
43 GFX_CTRL_CMD_ID_INIT_GPCOM_RING = 0x00020000, /* initialize GPCOM ring */
44 GFX_CTRL_CMD_ID_DESTROY_RINGS = 0x00030000, /* destroy rings */
45 GFX_CTRL_CMD_ID_CAN_INIT_RINGS = 0x00040000, /* is it allowed to initialized the rings */
46 GFX_CTRL_CMD_ID_ENABLE_INT = 0x00050000, /* enable PSP-to-Gfx interrupt */
47 GFX_CTRL_CMD_ID_DISABLE_INT = 0x00060000, /* disable PSP-to-Gfx interrupt */
48 GFX_CTRL_CMD_ID_MODE1_RST = 0x00070000, /* trigger the Mode 1 reset */
49 GFX_CTRL_CMD_ID_GBR_IH_SET = 0x00080000, /* set Gbr IH_RB_CNTL registers */
50 GFX_CTRL_CMD_ID_CONSUME_CMD = 0x00090000, /* send interrupt to psp for updating write pointer of vf */
51 GFX_CTRL_CMD_ID_DESTROY_GPCOM_RING = 0x000C0000, /* destroy GPCOM ring */
52
53 GFX_CTRL_CMD_ID_MAX = 0x000F0000, /* max command ID */
54};
55
56
57/*-----------------------------------------------------------------------------
58 NOTE: All physical addresses used in this interface are actually
59 GPU Virtual Addresses.
60*/
61
62
63/* Control registers of the TEE Gfx interface. These are located in
64* SRBM-to-PSP mailbox registers (total 8 registers).
65*/
66struct psp_gfx_ctrl
67{
68 volatile uint32_t cmd_resp; /* +0 Command/Response register for Gfx commands */
69 volatile uint32_t rbi_wptr; /* +4 Write pointer (index) of RBI ring */
70 volatile uint32_t rbi_rptr; /* +8 Read pointer (index) of RBI ring */
71 volatile uint32_t gpcom_wptr; /* +12 Write pointer (index) of GPCOM ring */
72 volatile uint32_t gpcom_rptr; /* +16 Read pointer (index) of GPCOM ring */
73 volatile uint32_t ring_addr_lo; /* +20 bits [31:0] of GPU Virtual of ring buffer (VMID=0)*/
74 volatile uint32_t ring_addr_hi; /* +24 bits [63:32] of GPU Virtual of ring buffer (VMID=0) */
75 volatile uint32_t ring_buf_size; /* +28 Ring buffer size (in bytes) */
76
77};
78
79
80/* Response flag is set in the command when command is completed by PSP.
81* Used in the GFX_CTRL.CmdResp.
82* When PSP GFX I/F is initialized, the flag is set.
83*/
84#define GFX_FLAG_RESPONSE 0x80000000
85
86/* TEE Gfx Command IDs for the ring buffer interface. */
87enum psp_gfx_cmd_id
88{
89 GFX_CMD_ID_LOAD_TA = 0x00000001, /* load TA */
90 GFX_CMD_ID_UNLOAD_TA = 0x00000002, /* unload TA */
91 GFX_CMD_ID_INVOKE_CMD = 0x00000003, /* send command to TA */
92 GFX_CMD_ID_LOAD_ASD = 0x00000004, /* load ASD Driver */
93 GFX_CMD_ID_SETUP_TMR = 0x00000005, /* setup TMR region */
94 GFX_CMD_ID_LOAD_IP_FW = 0x00000006, /* load HW IP FW */
95 GFX_CMD_ID_DESTROY_TMR = 0x00000007, /* destroy TMR region */
96 GFX_CMD_ID_SAVE_RESTORE = 0x00000008, /* save/restore HW IP FW */
97 GFX_CMD_ID_SETUP_VMR = 0x00000009, /* setup VMR region */
98 GFX_CMD_ID_DESTROY_VMR = 0x0000000A, /* destroy VMR region */
99 GFX_CMD_ID_PROG_REG = 0x0000000B, /* program regs */
100 GFX_CMD_ID_GET_FW_ATTESTATION = 0x0000000F, /* Query GPUVA of the Fw Attestation DB */
101 /* IDs upto 0x1F are reserved for older programs (Raven, Vega 10/12/20) */
102 GFX_CMD_ID_LOAD_TOC = 0x00000020, /* Load TOC and obtain TMR size */
103 GFX_CMD_ID_AUTOLOAD_RLC = 0x00000021, /* Indicates all graphics fw loaded, start RLC autoload */
104 GFX_CMD_ID_BOOT_CFG = 0x00000022, /* Boot Config */
105 GFX_CMD_ID_SRIOV_SPATIAL_PART = 0x00000027, /* Configure spatial partitioning mode */
106 /*IDs of performance monitoring/profiling*/
107 GFX_CMD_ID_CONFIG_SQ_PERFMON = 0x00000046, /* Config CGTT_SQ_CLK_CTRL */
108 /* Dynamic memory partitioninig (NPS mode change)*/
109 GFX_CMD_ID_FB_NPS_MODE = 0x00000048, /* Configure memory partitioning mode */
110};
111
112/* PSP boot config sub-commands */
113enum psp_gfx_boot_config_cmd
114{
115 BOOTCFG_CMD_SET = 1, /* Set boot configuration settings */
116 BOOTCFG_CMD_GET = 2, /* Get boot configuration settings */
117 BOOTCFG_CMD_INVALIDATE = 3 /* Reset current boot configuration settings to VBIOS defaults */
118};
119
120/* PSP boot config bitmask values */
121enum psp_gfx_boot_config
122{
123 BOOT_CONFIG_GECC = 0x1,
124};
125
126/* Command to load Trusted Application binary into PSP OS. */
127struct psp_gfx_cmd_load_ta
128{
129 uint32_t app_phy_addr_lo; /* bits [31:0] of the GPU Virtual address of the TA binary (must be 4 KB aligned) */
130 uint32_t app_phy_addr_hi; /* bits [63:32] of the GPU Virtual address of the TA binary */
131 uint32_t app_len; /* length of the TA binary in bytes */
132 uint32_t cmd_buf_phy_addr_lo; /* bits [31:0] of the GPU Virtual address of CMD buffer (must be 4 KB aligned) */
133 uint32_t cmd_buf_phy_addr_hi; /* bits [63:32] of the GPU Virtual address of CMD buffer */
134 uint32_t cmd_buf_len; /* length of the CMD buffer in bytes; must be multiple of 4 KB */
135
136 /* Note: CmdBufLen can be set to 0. In this case no persistent CMD buffer is provided
137 * for the TA. Each InvokeCommand can have dinamically mapped CMD buffer instead
138 * of using global persistent buffer.
139 */
140};
141
142
143/* Command to Unload Trusted Application binary from PSP OS. */
144struct psp_gfx_cmd_unload_ta
145{
146 uint32_t session_id; /* Session ID of the loaded TA to be unloaded */
147
148};
149
150
151/* Shared buffers for InvokeCommand.
152*/
153struct psp_gfx_buf_desc
154{
155 uint32_t buf_phy_addr_lo; /* bits [31:0] of GPU Virtual address of the buffer (must be 4 KB aligned) */
156 uint32_t buf_phy_addr_hi; /* bits [63:32] of GPU Virtual address of the buffer */
157 uint32_t buf_size; /* buffer size in bytes (must be multiple of 4 KB and no bigger than 64 MB) */
158
159};
160
161/* Max number of descriptors for one shared buffer (in how many different
162* physical locations one shared buffer can be stored). If buffer is too much
163* fragmented, error will be returned.
164*/
165#define GFX_BUF_MAX_DESC 64
166
167struct psp_gfx_buf_list
168{
169 uint32_t num_desc; /* number of buffer descriptors in the list */
170 uint32_t total_size; /* total size of all buffers in the list in bytes (must be multiple of 4 KB) */
171 struct psp_gfx_buf_desc buf_desc[GFX_BUF_MAX_DESC]; /* list of buffer descriptors */
172
173 /* total 776 bytes */
174};
175
176/* Command to execute InvokeCommand entry point of the TA. */
177struct psp_gfx_cmd_invoke_cmd
178{
179 uint32_t session_id; /* Session ID of the TA to be executed */
180 uint32_t ta_cmd_id; /* Command ID to be sent to TA */
181 struct psp_gfx_buf_list buf; /* one indirect buffer (scatter/gather list) */
182
183};
184
185
186/* Command to setup TMR region. */
187struct psp_gfx_cmd_setup_tmr
188{
189 uint32_t buf_phy_addr_lo; /* bits [31:0] of GPU Virtual address of TMR buffer (must be 4 KB aligned) */
190 uint32_t buf_phy_addr_hi; /* bits [63:32] of GPU Virtual address of TMR buffer */
191 uint32_t buf_size; /* buffer size in bytes (must be multiple of 4 KB) */
192 union {
193 struct {
194 uint32_t sriov_enabled:1; /* whether the device runs under SR-IOV*/
195 uint32_t virt_phy_addr:1; /* driver passes both virtual and physical address to PSP*/
196 uint32_t reserved:30;
197 } bitfield;
198 uint32_t tmr_flags;
199 };
200 uint32_t system_phy_addr_lo; /* bits [31:0] of system physical address of TMR buffer (must be 4 KB aligned) */
201 uint32_t system_phy_addr_hi; /* bits [63:32] of system physical address of TMR buffer */
202
203};
204
205/* FW types for GFX_CMD_ID_LOAD_IP_FW command. Limit 31. */
206enum psp_gfx_fw_type {
207 GFX_FW_TYPE_NONE = 0, /* */
208 GFX_FW_TYPE_CP_ME = 1, /* CP-ME VG + RV */
209 GFX_FW_TYPE_CP_PFP = 2, /* CP-PFP VG + RV */
210 GFX_FW_TYPE_CP_CE = 3, /* CP-CE VG + RV */
211 GFX_FW_TYPE_CP_MEC = 4, /* CP-MEC FW VG + RV */
212 GFX_FW_TYPE_CP_MEC_ME1 = 5, /* CP-MEC Jump Table 1 VG + RV */
213 GFX_FW_TYPE_CP_MEC_ME2 = 6, /* CP-MEC Jump Table 2 VG */
214 GFX_FW_TYPE_RLC_V = 7, /* RLC-V VG */
215 GFX_FW_TYPE_RLC_G = 8, /* RLC-G VG + RV */
216 GFX_FW_TYPE_SDMA0 = 9, /* SDMA0 VG + RV */
217 GFX_FW_TYPE_SDMA1 = 10, /* SDMA1 VG */
218 GFX_FW_TYPE_DMCU_ERAM = 11, /* DMCU-ERAM VG + RV */
219 GFX_FW_TYPE_DMCU_ISR = 12, /* DMCU-ISR VG + RV */
220 GFX_FW_TYPE_VCN = 13, /* VCN RV */
221 GFX_FW_TYPE_UVD = 14, /* UVD VG */
222 GFX_FW_TYPE_VCE = 15, /* VCE VG */
223 GFX_FW_TYPE_ISP = 16, /* ISP RV */
224 GFX_FW_TYPE_ACP = 17, /* ACP RV */
225 GFX_FW_TYPE_SMU = 18, /* SMU VG */
226 GFX_FW_TYPE_MMSCH = 19, /* MMSCH VG */
227 GFX_FW_TYPE_RLC_RESTORE_LIST_GPM_MEM = 20, /* RLC GPM VG + RV */
228 GFX_FW_TYPE_RLC_RESTORE_LIST_SRM_MEM = 21, /* RLC SRM VG + RV */
229 GFX_FW_TYPE_RLC_RESTORE_LIST_SRM_CNTL = 22, /* RLC CNTL VG + RV */
230 GFX_FW_TYPE_UVD1 = 23, /* UVD1 VG-20 */
231 GFX_FW_TYPE_TOC = 24, /* TOC NV-10 */
232 GFX_FW_TYPE_RLC_P = 25, /* RLC P NV */
233 GFX_FW_TYPE_RLC_IRAM = 26, /* RLC_IRAM NV */
234 GFX_FW_TYPE_GLOBAL_TAP_DELAYS = 27, /* GLOBAL TAP DELAYS NV */
235 GFX_FW_TYPE_SE0_TAP_DELAYS = 28, /* SE0 TAP DELAYS NV */
236 GFX_FW_TYPE_SE1_TAP_DELAYS = 29, /* SE1 TAP DELAYS NV */
237 GFX_FW_TYPE_GLOBAL_SE0_SE1_SKEW_DELAYS = 30, /* GLOBAL SE0/1 SKEW DELAYS NV */
238 GFX_FW_TYPE_SDMA0_JT = 31, /* SDMA0 JT NV */
239 GFX_FW_TYPE_SDMA1_JT = 32, /* SDNA1 JT NV */
240 GFX_FW_TYPE_CP_MES = 33, /* CP MES NV */
241 GFX_FW_TYPE_MES_STACK = 34, /* MES STACK NV */
242 GFX_FW_TYPE_RLC_SRM_DRAM_SR = 35, /* RLC SRM DRAM NV */
243 GFX_FW_TYPE_RLCG_SCRATCH_SR = 36, /* RLCG SCRATCH NV */
244 GFX_FW_TYPE_RLCP_SCRATCH_SR = 37, /* RLCP SCRATCH NV */
245 GFX_FW_TYPE_RLCV_SCRATCH_SR = 38, /* RLCV SCRATCH NV */
246 GFX_FW_TYPE_RLX6_DRAM_SR = 39, /* RLX6 DRAM NV */
247 GFX_FW_TYPE_SDMA0_PG_CONTEXT = 40, /* SDMA0 PG CONTEXT NV */
248 GFX_FW_TYPE_SDMA1_PG_CONTEXT = 41, /* SDMA1 PG CONTEXT NV */
249 GFX_FW_TYPE_GLOBAL_MUX_SELECT_RAM = 42, /* GLOBAL MUX SEL RAM NV */
250 GFX_FW_TYPE_SE0_MUX_SELECT_RAM = 43, /* SE0 MUX SEL RAM NV */
251 GFX_FW_TYPE_SE1_MUX_SELECT_RAM = 44, /* SE1 MUX SEL RAM NV */
252 GFX_FW_TYPE_ACCUM_CTRL_RAM = 45, /* ACCUM CTRL RAM NV */
253 GFX_FW_TYPE_RLCP_CAM = 46, /* RLCP CAM NV */
254 GFX_FW_TYPE_RLC_SPP_CAM_EXT = 47, /* RLC SPP CAM EXT NV */
255 GFX_FW_TYPE_RLC_DRAM_BOOT = 48, /* RLC DRAM BOOT NV */
256 GFX_FW_TYPE_VCN0_RAM = 49, /* VCN_RAM NV + RN */
257 GFX_FW_TYPE_VCN1_RAM = 50, /* VCN_RAM NV + RN */
258 GFX_FW_TYPE_DMUB = 51, /* DMUB RN */
259 GFX_FW_TYPE_SDMA2 = 52, /* SDMA2 MI */
260 GFX_FW_TYPE_SDMA3 = 53, /* SDMA3 MI */
261 GFX_FW_TYPE_SDMA4 = 54, /* SDMA4 MI */
262 GFX_FW_TYPE_SDMA5 = 55, /* SDMA5 MI */
263 GFX_FW_TYPE_SDMA6 = 56, /* SDMA6 MI */
264 GFX_FW_TYPE_SDMA7 = 57, /* SDMA7 MI */
265 GFX_FW_TYPE_VCN1 = 58, /* VCN1 MI */
266 GFX_FW_TYPE_CAP = 62, /* CAP_FW */
267 GFX_FW_TYPE_SE2_TAP_DELAYS = 65, /* SE2 TAP DELAYS NV */
268 GFX_FW_TYPE_SE3_TAP_DELAYS = 66, /* SE3 TAP DELAYS NV */
269 GFX_FW_TYPE_REG_LIST = 67, /* REG_LIST MI */
270 GFX_FW_TYPE_IMU_I = 68, /* IMU Instruction FW SOC21 */
271 GFX_FW_TYPE_IMU_D = 69, /* IMU Data FW SOC21 */
272 GFX_FW_TYPE_LSDMA = 70, /* LSDMA FW SOC21 */
273 GFX_FW_TYPE_SDMA_UCODE_TH0 = 71, /* SDMA Thread 0/CTX SOC21 */
274 GFX_FW_TYPE_SDMA_UCODE_TH1 = 72, /* SDMA Thread 1/CTL SOC21 */
275 GFX_FW_TYPE_PPTABLE = 73, /* PPTABLE SOC21 */
276 GFX_FW_TYPE_DISCRETE_USB4 = 74, /* dUSB4 FW SOC21 */
277 GFX_FW_TYPE_TA = 75, /* SRIOV TA FW UUID SOC21 */
278 GFX_FW_TYPE_RS64_MES = 76, /* RS64 MES ucode SOC21 */
279 GFX_FW_TYPE_RS64_MES_STACK = 77, /* RS64 MES stack ucode SOC21 */
280 GFX_FW_TYPE_RS64_KIQ = 78, /* RS64 KIQ ucode SOC21 */
281 GFX_FW_TYPE_RS64_KIQ_STACK = 79, /* RS64 KIQ Heap stack SOC21 */
282 GFX_FW_TYPE_ISP_DATA = 80, /* ISP DATA SOC21 */
283 GFX_FW_TYPE_CP_MES_KIQ = 81, /* MES KIQ ucode SOC21 */
284 GFX_FW_TYPE_MES_KIQ_STACK = 82, /* MES KIQ stack SOC21 */
285 GFX_FW_TYPE_UMSCH_DATA = 83, /* User Mode Scheduler Data SOC21 */
286 GFX_FW_TYPE_UMSCH_UCODE = 84, /* User Mode Scheduler Ucode SOC21 */
287 GFX_FW_TYPE_UMSCH_CMD_BUFFER = 85, /* User Mode Scheduler Command Buffer SOC21 */
288 GFX_FW_TYPE_USB_DP_COMBO_PHY = 86, /* USB-Display port Combo SOC21 */
289 GFX_FW_TYPE_RS64_PFP = 87, /* RS64 PFP SOC21 */
290 GFX_FW_TYPE_RS64_ME = 88, /* RS64 ME SOC21 */
291 GFX_FW_TYPE_RS64_MEC = 89, /* RS64 MEC SOC21 */
292 GFX_FW_TYPE_RS64_PFP_P0_STACK = 90, /* RS64 PFP stack P0 SOC21 */
293 GFX_FW_TYPE_RS64_PFP_P1_STACK = 91, /* RS64 PFP stack P1 SOC21 */
294 GFX_FW_TYPE_RS64_ME_P0_STACK = 92, /* RS64 ME stack P0 SOC21 */
295 GFX_FW_TYPE_RS64_ME_P1_STACK = 93, /* RS64 ME stack P1 SOC21 */
296 GFX_FW_TYPE_RS64_MEC_P0_STACK = 94, /* RS64 MEC stack P0 SOC21 */
297 GFX_FW_TYPE_RS64_MEC_P1_STACK = 95, /* RS64 MEC stack P1 SOC21 */
298 GFX_FW_TYPE_RS64_MEC_P2_STACK = 96, /* RS64 MEC stack P2 SOC21 */
299 GFX_FW_TYPE_RS64_MEC_P3_STACK = 97, /* RS64 MEC stack P3 SOC21 */
300 GFX_FW_TYPE_VPEC_FW1 = 100, /* VPEC FW1 To Save VPE */
301 GFX_FW_TYPE_VPEC_FW2 = 101, /* VPEC FW2 To Save VPE */
302 GFX_FW_TYPE_VPE = 102,
303 GFX_FW_TYPE_JPEG_RAM = 128, /**< JPEG Command buffer */
304 GFX_FW_TYPE_P2S_TABLE = 129,
305 GFX_FW_TYPE_MAX
306};
307
308/* Command to load HW IP FW. */
309struct psp_gfx_cmd_load_ip_fw
310{
311 uint32_t fw_phy_addr_lo; /* bits [31:0] of GPU Virtual address of FW location (must be 4 KB aligned) */
312 uint32_t fw_phy_addr_hi; /* bits [63:32] of GPU Virtual address of FW location */
313 uint32_t fw_size; /* FW buffer size in bytes */
314 enum psp_gfx_fw_type fw_type; /* FW type */
315
316};
317
318/* Command to save/restore HW IP FW. */
319struct psp_gfx_cmd_save_restore_ip_fw
320{
321 uint32_t save_fw; /* if set, command is used for saving fw otherwise for resetoring*/
322 uint32_t save_restore_addr_lo; /* bits [31:0] of FB address of GART memory used as save/restore buffer (must be 4 KB aligned) */
323 uint32_t save_restore_addr_hi; /* bits [63:32] of FB address of GART memory used as save/restore buffer */
324 uint32_t buf_size; /* Size of the save/restore buffer in bytes */
325 enum psp_gfx_fw_type fw_type; /* FW type */
326};
327
328/* Command to setup register program */
329struct psp_gfx_cmd_reg_prog {
330 uint32_t reg_value;
331 uint32_t reg_id;
332};
333
334/* Command to load TOC */
335struct psp_gfx_cmd_load_toc
336{
337 uint32_t toc_phy_addr_lo; /* bits [31:0] of GPU Virtual address of FW location (must be 4 KB aligned) */
338 uint32_t toc_phy_addr_hi; /* bits [63:32] of GPU Virtual address of FW location */
339 uint32_t toc_size; /* FW buffer size in bytes */
340};
341
342/* Dynamic boot configuration */
343struct psp_gfx_cmd_boot_cfg
344{
345 uint32_t timestamp; /* calendar time as number of seconds */
346 enum psp_gfx_boot_config_cmd sub_cmd; /* sub-command indicating how to process command data */
347 uint32_t boot_config; /* dynamic boot configuration bitmask */
348 uint32_t boot_config_valid; /* dynamic boot configuration valid bits bitmask */
349};
350
351struct psp_gfx_cmd_sriov_spatial_part {
352 uint32_t mode;
353 uint32_t override_ips;
354 uint32_t override_xcds_avail;
355 uint32_t override_this_aid;
356};
357
358/*Structure for sq performance monitoring/profiling enable/disable*/
359struct psp_gfx_cmd_config_sq_perfmon {
360 uint32_t gfx_xcp_mask;
361 uint8_t core_override;
362 uint8_t reg_override;
363 uint8_t perfmon_override;
364 uint8_t reserved[5];
365};
366
367struct psp_gfx_cmd_fb_memory_part {
368 uint32_t mode; /* requested NPS mode */
369 uint32_t resvd;
370};
371
372/* All GFX ring buffer commands. */
373union psp_gfx_commands
374{
375 struct psp_gfx_cmd_load_ta cmd_load_ta;
376 struct psp_gfx_cmd_unload_ta cmd_unload_ta;
377 struct psp_gfx_cmd_invoke_cmd cmd_invoke_cmd;
378 struct psp_gfx_cmd_setup_tmr cmd_setup_tmr;
379 struct psp_gfx_cmd_load_ip_fw cmd_load_ip_fw;
380 struct psp_gfx_cmd_save_restore_ip_fw cmd_save_restore_ip_fw;
381 struct psp_gfx_cmd_reg_prog cmd_setup_reg_prog;
382 struct psp_gfx_cmd_setup_tmr cmd_setup_vmr;
383 struct psp_gfx_cmd_load_toc cmd_load_toc;
384 struct psp_gfx_cmd_boot_cfg boot_cfg;
385 struct psp_gfx_cmd_sriov_spatial_part cmd_spatial_part;
386 struct psp_gfx_cmd_config_sq_perfmon config_sq_perfmon;
387 struct psp_gfx_cmd_fb_memory_part cmd_memory_part;
388};
389
390struct psp_gfx_uresp_reserved
391{
392 uint32_t reserved[8];
393};
394
395/* Command-specific response for Fw Attestation Db */
396struct psp_gfx_uresp_fwar_db_info
397{
398 uint32_t fwar_db_addr_lo;
399 uint32_t fwar_db_addr_hi;
400};
401
402/* Command-specific response for boot config. */
403struct psp_gfx_uresp_bootcfg {
404 uint32_t boot_cfg; /* boot config data */
405};
406
407/* Union of command-specific responses for GPCOM ring. */
408union psp_gfx_uresp {
409 struct psp_gfx_uresp_reserved reserved;
410 struct psp_gfx_uresp_bootcfg boot_cfg;
411 struct psp_gfx_uresp_fwar_db_info fwar_db_info;
412};
413
414/* Structure of GFX Response buffer.
415* For GPCOM I/F it is part of GFX_CMD_RESP buffer, for RBI
416* it is separate buffer.
417*/
418struct psp_gfx_resp
419{
420 uint32_t status; /* +0 status of command execution */
421 uint32_t session_id; /* +4 session ID in response to LoadTa command */
422 uint32_t fw_addr_lo; /* +8 bits [31:0] of FW address within TMR (in response to cmd_load_ip_fw command) */
423 uint32_t fw_addr_hi; /* +12 bits [63:32] of FW address within TMR (in response to cmd_load_ip_fw command) */
424 uint32_t tmr_size; /* +16 size of the TMR to be reserved including MM fw and Gfx fw in response to cmd_load_toc command */
425
426 uint32_t reserved[11];
427
428 union psp_gfx_uresp uresp; /* +64 response union containing command-specific responses */
429
430 /* total 96 bytes */
431};
432
433/* Structure of Command buffer pointed by psp_gfx_rb_frame.cmd_buf_addr_hi
434* and psp_gfx_rb_frame.cmd_buf_addr_lo.
435*/
436struct psp_gfx_cmd_resp
437{
438 uint32_t buf_size; /* +0 total size of the buffer in bytes */
439 uint32_t buf_version; /* +4 version of the buffer strusture; must be PSP_GFX_CMD_BUF_VERSION */
440 uint32_t cmd_id; /* +8 command ID */
441
442 /* These fields are used for RBI only. They are all 0 in GPCOM commands
443 */
444 uint32_t resp_buf_addr_lo; /* +12 bits [31:0] of GPU Virtual address of response buffer (must be 4 KB aligned) */
445 uint32_t resp_buf_addr_hi; /* +16 bits [63:32] of GPU Virtual address of response buffer */
446 uint32_t resp_offset; /* +20 offset within response buffer */
447 uint32_t resp_buf_size; /* +24 total size of the response buffer in bytes */
448
449 union psp_gfx_commands cmd; /* +28 command specific structures */
450
451 uint8_t reserved_1[864 - sizeof(union psp_gfx_commands) - 28];
452
453 /* Note: Resp is part of this buffer for GPCOM ring. For RBI ring the response
454 * is separate buffer pointed by resp_buf_addr_hi and resp_buf_addr_lo.
455 */
456 struct psp_gfx_resp resp; /* +864 response */
457
458 uint8_t reserved_2[1024 - 864 - sizeof(struct psp_gfx_resp)];
459
460 /* total size 1024 bytes */
461};
462
463
464#define FRAME_TYPE_DESTROY 1 /* frame sent by KMD driver when UMD Scheduler context is destroyed*/
465
466/* Structure of the Ring Buffer Frame */
467struct psp_gfx_rb_frame
468{
469 uint32_t cmd_buf_addr_lo; /* +0 bits [31:0] of GPU Virtual address of command buffer (must be 4 KB aligned) */
470 uint32_t cmd_buf_addr_hi; /* +4 bits [63:32] of GPU Virtual address of command buffer */
471 uint32_t cmd_buf_size; /* +8 command buffer size in bytes */
472 uint32_t fence_addr_lo; /* +12 bits [31:0] of GPU Virtual address of Fence for this frame */
473 uint32_t fence_addr_hi; /* +16 bits [63:32] of GPU Virtual address of Fence for this frame */
474 uint32_t fence_value; /* +20 Fence value */
475 uint32_t sid_lo; /* +24 bits [31:0] of SID value (used only for RBI frames) */
476 uint32_t sid_hi; /* +28 bits [63:32] of SID value (used only for RBI frames) */
477 uint8_t vmid; /* +32 VMID value used for mapping of all addresses for this frame */
478 uint8_t frame_type; /* +33 1: destory context frame, 0: all other frames; used only for RBI frames */
479 uint8_t reserved1[2]; /* +34 reserved, must be 0 */
480 uint32_t reserved2[7]; /* +36 reserved, must be 0 */
481 /* total 64 bytes */
482};
483
484#define PSP_ERR_UNKNOWN_COMMAND 0x00000100
485
486enum tee_error_code {
487 TEE_SUCCESS = 0x00000000,
488 TEE_ERROR_CANCEL = 0xFFFF0002,
489 TEE_ERROR_NOT_SUPPORTED = 0xFFFF000A,
490};
491
492#endif /* _PSP_TEE_GFX_IF_H_ */