1 /* 2 * Copyright 2016 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 * Author: Huang Rui 23 * 24 */ 25 #ifndef __AMDGPU_PSP_H__ 26 #define __AMDGPU_PSP_H__ 27 28 #include "amdgpu.h" 29 #include "psp_gfx_if.h" 30 #include "ta_xgmi_if.h" 31 #include "ta_ras_if.h" 32 #include "ta_rap_if.h" 33 #include "ta_secureDisplay_if.h" 34 35 #define PSP_FENCE_BUFFER_SIZE 0x1000 36 #define PSP_CMD_BUFFER_SIZE 0x1000 37 #define PSP_XGMI_SHARED_MEM_SIZE 0x4000 38 #define PSP_RAS_SHARED_MEM_SIZE 0x4000 39 #define PSP_1_MEG 0x100000 40 #define PSP_TMR_SIZE(adev) ((adev)->asic_type == CHIP_ALDEBARAN ? 0x800000 : 0x400000) 41 #define PSP_HDCP_SHARED_MEM_SIZE 0x4000 42 #define PSP_DTM_SHARED_MEM_SIZE 0x4000 43 #define PSP_RAP_SHARED_MEM_SIZE 0x4000 44 #define PSP_SECUREDISPLAY_SHARED_MEM_SIZE 0x4000 45 #define PSP_SHARED_MEM_SIZE 0x4000 46 #define PSP_FW_NAME_LEN 0x24 47 48 struct psp_context; 49 struct psp_xgmi_node_info; 50 struct psp_xgmi_topology_info; 51 struct psp_bin_desc; 52 53 enum psp_bootloader_cmd { 54 PSP_BL__LOAD_SYSDRV = 0x10000, 55 PSP_BL__LOAD_SOSDRV = 0x20000, 56 PSP_BL__LOAD_KEY_DATABASE = 0x80000, 57 PSP_BL__DRAM_LONG_TRAIN = 0x100000, 58 PSP_BL__DRAM_SHORT_TRAIN = 0x200000, 59 PSP_BL__LOAD_TOS_SPL_TABLE = 0x10000000, 60 }; 61 62 enum psp_ring_type 63 { 64 PSP_RING_TYPE__INVALID = 0, 65 /* 66 * These values map to the way the PSP kernel identifies the 67 * rings. 68 */ 69 PSP_RING_TYPE__UM = 1, /* User mode ring (formerly called RBI) */ 70 PSP_RING_TYPE__KM = 2 /* Kernel mode ring (formerly called GPCOM) */ 71 }; 72 73 struct psp_ring 74 { 75 enum psp_ring_type ring_type; 76 struct psp_gfx_rb_frame *ring_mem; 77 uint64_t ring_mem_mc_addr; 78 void *ring_mem_handle; 79 uint32_t ring_size; 80 uint32_t ring_wptr; 81 }; 82 83 /* More registers may will be supported */ 84 enum psp_reg_prog_id { 85 PSP_REG_IH_RB_CNTL = 0, /* register IH_RB_CNTL */ 86 PSP_REG_IH_RB_CNTL_RING1 = 1, /* register IH_RB_CNTL_RING1 */ 87 PSP_REG_IH_RB_CNTL_RING2 = 2, /* register IH_RB_CNTL_RING2 */ 88 PSP_REG_LAST 89 }; 90 91 struct psp_funcs 92 { 93 int (*init_microcode)(struct psp_context *psp); 94 int (*bootloader_load_kdb)(struct psp_context *psp); 95 int (*bootloader_load_spl)(struct psp_context *psp); 96 int (*bootloader_load_sysdrv)(struct psp_context *psp); 97 int (*bootloader_load_sos)(struct psp_context *psp); 98 int (*ring_init)(struct psp_context *psp, enum psp_ring_type ring_type); 99 int (*ring_create)(struct psp_context *psp, 100 enum psp_ring_type ring_type); 101 int (*ring_stop)(struct psp_context *psp, 102 enum psp_ring_type ring_type); 103 int (*ring_destroy)(struct psp_context *psp, 104 enum psp_ring_type ring_type); 105 bool (*smu_reload_quirk)(struct psp_context *psp); 106 int (*mode1_reset)(struct psp_context *psp); 107 int (*mem_training)(struct psp_context *psp, uint32_t ops); 108 uint32_t (*ring_get_wptr)(struct psp_context *psp); 109 void (*ring_set_wptr)(struct psp_context *psp, uint32_t value); 110 int (*load_usbc_pd_fw)(struct psp_context *psp, uint64_t fw_pri_mc_addr); 111 int (*read_usbc_pd_fw)(struct psp_context *psp, uint32_t *fw_ver); 112 }; 113 114 #define AMDGPU_XGMI_MAX_CONNECTED_NODES 64 115 struct psp_xgmi_node_info { 116 uint64_t node_id; 117 uint8_t num_hops; 118 uint8_t is_sharing_enabled; 119 enum ta_xgmi_assigned_sdma_engine sdma_engine; 120 uint8_t num_links; 121 }; 122 123 struct psp_xgmi_topology_info { 124 uint32_t num_nodes; 125 struct psp_xgmi_node_info nodes[AMDGPU_XGMI_MAX_CONNECTED_NODES]; 126 }; 127 128 struct psp_asd_context { 129 bool asd_initialized; 130 uint32_t session_id; 131 }; 132 133 struct psp_xgmi_context { 134 uint8_t initialized; 135 uint32_t session_id; 136 struct amdgpu_bo *xgmi_shared_bo; 137 uint64_t xgmi_shared_mc_addr; 138 void *xgmi_shared_buf; 139 struct psp_xgmi_topology_info top_info; 140 }; 141 142 struct psp_ras_context { 143 /*ras fw*/ 144 bool ras_initialized; 145 uint32_t session_id; 146 struct amdgpu_bo *ras_shared_bo; 147 uint64_t ras_shared_mc_addr; 148 void *ras_shared_buf; 149 struct amdgpu_ras *ras; 150 }; 151 152 struct psp_hdcp_context { 153 bool hdcp_initialized; 154 uint32_t session_id; 155 struct amdgpu_bo *hdcp_shared_bo; 156 uint64_t hdcp_shared_mc_addr; 157 void *hdcp_shared_buf; 158 struct mutex mutex; 159 }; 160 161 struct psp_dtm_context { 162 bool dtm_initialized; 163 uint32_t session_id; 164 struct amdgpu_bo *dtm_shared_bo; 165 uint64_t dtm_shared_mc_addr; 166 void *dtm_shared_buf; 167 struct mutex mutex; 168 }; 169 170 struct psp_rap_context { 171 bool rap_initialized; 172 uint32_t session_id; 173 struct amdgpu_bo *rap_shared_bo; 174 uint64_t rap_shared_mc_addr; 175 void *rap_shared_buf; 176 struct mutex mutex; 177 }; 178 179 struct psp_securedisplay_context { 180 bool securedisplay_initialized; 181 uint32_t session_id; 182 struct amdgpu_bo *securedisplay_shared_bo; 183 uint64_t securedisplay_shared_mc_addr; 184 void *securedisplay_shared_buf; 185 struct mutex mutex; 186 }; 187 188 #define MEM_TRAIN_SYSTEM_SIGNATURE 0x54534942 189 #define GDDR6_MEM_TRAINING_DATA_SIZE_IN_BYTES 0x1000 190 #define GDDR6_MEM_TRAINING_OFFSET 0x8000 191 /*Define the VRAM size that will be encroached by BIST training.*/ 192 #define GDDR6_MEM_TRAINING_ENCROACHED_SIZE 0x2000000 193 194 enum psp_memory_training_init_flag { 195 PSP_MEM_TRAIN_NOT_SUPPORT = 0x0, 196 PSP_MEM_TRAIN_SUPPORT = 0x1, 197 PSP_MEM_TRAIN_INIT_FAILED = 0x2, 198 PSP_MEM_TRAIN_RESERVE_SUCCESS = 0x4, 199 PSP_MEM_TRAIN_INIT_SUCCESS = 0x8, 200 }; 201 202 enum psp_memory_training_ops { 203 PSP_MEM_TRAIN_SEND_LONG_MSG = 0x1, 204 PSP_MEM_TRAIN_SAVE = 0x2, 205 PSP_MEM_TRAIN_RESTORE = 0x4, 206 PSP_MEM_TRAIN_SEND_SHORT_MSG = 0x8, 207 PSP_MEM_TRAIN_COLD_BOOT = PSP_MEM_TRAIN_SEND_LONG_MSG, 208 PSP_MEM_TRAIN_RESUME = PSP_MEM_TRAIN_SEND_SHORT_MSG, 209 }; 210 211 struct psp_memory_training_context { 212 /*training data size*/ 213 u64 train_data_size; 214 /* 215 * sys_cache 216 * cpu virtual address 217 * system memory buffer that used to store the training data. 218 */ 219 void *sys_cache; 220 221 /*vram offset of the p2c training data*/ 222 u64 p2c_train_data_offset; 223 224 /*vram offset of the c2p training data*/ 225 u64 c2p_train_data_offset; 226 struct amdgpu_bo *c2p_bo; 227 228 enum psp_memory_training_init_flag init; 229 u32 training_cnt; 230 bool enable_mem_training; 231 }; 232 233 /** PSP runtime DB **/ 234 #define PSP_RUNTIME_DB_SIZE_IN_BYTES 0x10000 235 #define PSP_RUNTIME_DB_OFFSET 0x100000 236 #define PSP_RUNTIME_DB_COOKIE_ID 0x0ed5 237 #define PSP_RUNTIME_DB_VER_1 0x0100 238 #define PSP_RUNTIME_DB_DIAG_ENTRY_MAX_COUNT 0x40 239 240 enum psp_runtime_entry_type { 241 PSP_RUNTIME_ENTRY_TYPE_INVALID = 0x0, 242 PSP_RUNTIME_ENTRY_TYPE_TEST = 0x1, 243 PSP_RUNTIME_ENTRY_TYPE_MGPU_COMMON = 0x2, /* Common mGPU runtime data */ 244 PSP_RUNTIME_ENTRY_TYPE_MGPU_WAFL = 0x3, /* WAFL runtime data */ 245 PSP_RUNTIME_ENTRY_TYPE_MGPU_XGMI = 0x4, /* XGMI runtime data */ 246 PSP_RUNTIME_ENTRY_TYPE_BOOT_CONFIG = 0x5, /* Boot Config runtime data */ 247 }; 248 249 /* PSP runtime DB header */ 250 struct psp_runtime_data_header { 251 /* determine the existence of runtime db */ 252 uint16_t cookie; 253 /* version of runtime db */ 254 uint16_t version; 255 }; 256 257 /* PSP runtime DB entry */ 258 struct psp_runtime_entry { 259 /* type of runtime db entry */ 260 uint32_t entry_type; 261 /* offset of entry in bytes */ 262 uint16_t offset; 263 /* size of entry in bytes */ 264 uint16_t size; 265 }; 266 267 /* PSP runtime DB directory */ 268 struct psp_runtime_data_directory { 269 /* number of valid entries */ 270 uint16_t entry_count; 271 /* db entries*/ 272 struct psp_runtime_entry entry_list[PSP_RUNTIME_DB_DIAG_ENTRY_MAX_COUNT]; 273 }; 274 275 /* PSP runtime DB boot config feature bitmask */ 276 enum psp_runtime_boot_cfg_feature { 277 BOOT_CFG_FEATURE_GECC = 0x1, 278 BOOT_CFG_FEATURE_TWO_STAGE_DRAM_TRAINING = 0x2, 279 }; 280 281 /* PSP runtime DB boot config entry */ 282 struct psp_runtime_boot_cfg_entry { 283 uint32_t boot_cfg_bitmask; 284 uint32_t reserved; 285 }; 286 287 struct psp_bin_desc { 288 uint32_t fw_version; 289 uint32_t feature_version; 290 uint32_t size_bytes; 291 uint8_t *start_addr; 292 }; 293 294 struct psp_context 295 { 296 struct amdgpu_device *adev; 297 struct psp_ring km_ring; 298 struct psp_gfx_cmd_resp *cmd; 299 300 const struct psp_funcs *funcs; 301 302 /* firmware buffer */ 303 struct amdgpu_bo *fw_pri_bo; 304 uint64_t fw_pri_mc_addr; 305 void *fw_pri_buf; 306 307 /* sos firmware */ 308 const struct firmware *sos_fw; 309 struct psp_bin_desc sys; 310 struct psp_bin_desc sos; 311 struct psp_bin_desc toc; 312 struct psp_bin_desc kdb; 313 struct psp_bin_desc spl; 314 struct psp_bin_desc rl; 315 316 /* tmr buffer */ 317 struct amdgpu_bo *tmr_bo; 318 uint64_t tmr_mc_addr; 319 320 /* asd firmware */ 321 const struct firmware *asd_fw; 322 uint32_t asd_fw_version; 323 uint32_t asd_feature_version; 324 uint32_t asd_ucode_size; 325 uint8_t *asd_start_addr; 326 327 /* toc firmware */ 328 const struct firmware *toc_fw; 329 330 /* fence buffer */ 331 struct amdgpu_bo *fence_buf_bo; 332 uint64_t fence_buf_mc_addr; 333 void *fence_buf; 334 335 /* cmd buffer */ 336 struct amdgpu_bo *cmd_buf_bo; 337 uint64_t cmd_buf_mc_addr; 338 struct psp_gfx_cmd_resp *cmd_buf_mem; 339 340 /* fence value associated with cmd buffer */ 341 atomic_t fence_value; 342 /* flag to mark whether gfx fw autoload is supported or not */ 343 bool autoload_supported; 344 /* flag to mark whether df cstate management centralized to PMFW */ 345 bool pmfw_centralized_cstate_management; 346 347 /* xgmi ta firmware and buffer */ 348 const struct firmware *ta_fw; 349 uint32_t ta_fw_version; 350 uint32_t ta_xgmi_ucode_version; 351 uint32_t ta_xgmi_ucode_size; 352 uint8_t *ta_xgmi_start_addr; 353 uint32_t ta_ras_ucode_version; 354 uint32_t ta_ras_ucode_size; 355 uint8_t *ta_ras_start_addr; 356 357 uint32_t ta_hdcp_ucode_version; 358 uint32_t ta_hdcp_ucode_size; 359 uint8_t *ta_hdcp_start_addr; 360 361 uint32_t ta_dtm_ucode_version; 362 uint32_t ta_dtm_ucode_size; 363 uint8_t *ta_dtm_start_addr; 364 365 uint32_t ta_rap_ucode_version; 366 uint32_t ta_rap_ucode_size; 367 uint8_t *ta_rap_start_addr; 368 369 uint32_t ta_securedisplay_ucode_version; 370 uint32_t ta_securedisplay_ucode_size; 371 uint8_t *ta_securedisplay_start_addr; 372 373 struct psp_asd_context asd_context; 374 struct psp_xgmi_context xgmi_context; 375 struct psp_ras_context ras; 376 struct psp_hdcp_context hdcp_context; 377 struct psp_dtm_context dtm_context; 378 struct psp_rap_context rap_context; 379 struct psp_securedisplay_context securedisplay_context; 380 struct mutex mutex; 381 struct psp_memory_training_context mem_train_ctx; 382 383 uint32_t boot_cfg_bitmask; 384 }; 385 386 struct amdgpu_psp_funcs { 387 bool (*check_fw_loading_status)(struct amdgpu_device *adev, 388 enum AMDGPU_UCODE_ID); 389 }; 390 391 392 #define psp_ring_init(psp, type) (psp)->funcs->ring_init((psp), (type)) 393 #define psp_ring_create(psp, type) (psp)->funcs->ring_create((psp), (type)) 394 #define psp_ring_stop(psp, type) (psp)->funcs->ring_stop((psp), (type)) 395 #define psp_ring_destroy(psp, type) ((psp)->funcs->ring_destroy((psp), (type))) 396 #define psp_init_microcode(psp) \ 397 ((psp)->funcs->init_microcode ? (psp)->funcs->init_microcode((psp)) : 0) 398 #define psp_bootloader_load_kdb(psp) \ 399 ((psp)->funcs->bootloader_load_kdb ? (psp)->funcs->bootloader_load_kdb((psp)) : 0) 400 #define psp_bootloader_load_spl(psp) \ 401 ((psp)->funcs->bootloader_load_spl ? (psp)->funcs->bootloader_load_spl((psp)) : 0) 402 #define psp_bootloader_load_sysdrv(psp) \ 403 ((psp)->funcs->bootloader_load_sysdrv ? (psp)->funcs->bootloader_load_sysdrv((psp)) : 0) 404 #define psp_bootloader_load_sos(psp) \ 405 ((psp)->funcs->bootloader_load_sos ? (psp)->funcs->bootloader_load_sos((psp)) : 0) 406 #define psp_smu_reload_quirk(psp) \ 407 ((psp)->funcs->smu_reload_quirk ? (psp)->funcs->smu_reload_quirk((psp)) : false) 408 #define psp_mode1_reset(psp) \ 409 ((psp)->funcs->mode1_reset ? (psp)->funcs->mode1_reset((psp)) : false) 410 #define psp_mem_training(psp, ops) \ 411 ((psp)->funcs->mem_training ? (psp)->funcs->mem_training((psp), (ops)) : 0) 412 413 #define psp_ring_get_wptr(psp) (psp)->funcs->ring_get_wptr((psp)) 414 #define psp_ring_set_wptr(psp, value) (psp)->funcs->ring_set_wptr((psp), (value)) 415 416 #define psp_load_usbc_pd_fw(psp, fw_pri_mc_addr) \ 417 ((psp)->funcs->load_usbc_pd_fw ? \ 418 (psp)->funcs->load_usbc_pd_fw((psp), (fw_pri_mc_addr)) : -EINVAL) 419 420 #define psp_read_usbc_pd_fw(psp, fw_ver) \ 421 ((psp)->funcs->read_usbc_pd_fw ? \ 422 (psp)->funcs->read_usbc_pd_fw((psp), fw_ver) : -EINVAL) 423 424 extern const struct amd_ip_funcs psp_ip_funcs; 425 426 extern const struct amdgpu_ip_block_version psp_v3_1_ip_block; 427 extern const struct amdgpu_ip_block_version psp_v10_0_ip_block; 428 extern const struct amdgpu_ip_block_version psp_v11_0_ip_block; 429 extern const struct amdgpu_ip_block_version psp_v11_0_8_ip_block; 430 extern const struct amdgpu_ip_block_version psp_v12_0_ip_block; 431 extern const struct amdgpu_ip_block_version psp_v13_0_ip_block; 432 433 extern int psp_wait_for(struct psp_context *psp, uint32_t reg_index, 434 uint32_t field_val, uint32_t mask, bool check_changed); 435 436 int psp_gpu_reset(struct amdgpu_device *adev); 437 int psp_update_vcn_sram(struct amdgpu_device *adev, int inst_idx, 438 uint64_t cmd_gpu_addr, int cmd_size); 439 440 int psp_xgmi_initialize(struct psp_context *psp); 441 int psp_xgmi_terminate(struct psp_context *psp); 442 int psp_xgmi_invoke(struct psp_context *psp, uint32_t ta_cmd_id); 443 int psp_xgmi_get_hive_id(struct psp_context *psp, uint64_t *hive_id); 444 int psp_xgmi_get_node_id(struct psp_context *psp, uint64_t *node_id); 445 int psp_xgmi_get_topology_info(struct psp_context *psp, 446 int number_devices, 447 struct psp_xgmi_topology_info *topology); 448 int psp_xgmi_set_topology_info(struct psp_context *psp, 449 int number_devices, 450 struct psp_xgmi_topology_info *topology); 451 452 int psp_ras_invoke(struct psp_context *psp, uint32_t ta_cmd_id); 453 int psp_ras_enable_features(struct psp_context *psp, 454 union ta_ras_cmd_input *info, bool enable); 455 int psp_ras_trigger_error(struct psp_context *psp, 456 struct ta_ras_trigger_error_input *info); 457 458 int psp_hdcp_invoke(struct psp_context *psp, uint32_t ta_cmd_id); 459 int psp_dtm_invoke(struct psp_context *psp, uint32_t ta_cmd_id); 460 int psp_rap_invoke(struct psp_context *psp, uint32_t ta_cmd_id, enum ta_rap_status *status); 461 int psp_securedisplay_invoke(struct psp_context *psp, uint32_t ta_cmd_id); 462 463 int psp_rlc_autoload_start(struct psp_context *psp); 464 465 int psp_reg_program(struct psp_context *psp, enum psp_reg_prog_id reg, 466 uint32_t value); 467 int psp_ring_cmd_submit(struct psp_context *psp, 468 uint64_t cmd_buf_mc_addr, 469 uint64_t fence_mc_addr, 470 int index); 471 int psp_init_asd_microcode(struct psp_context *psp, 472 const char *chip_name); 473 int psp_init_toc_microcode(struct psp_context *psp, 474 const char *chip_name); 475 int psp_init_sos_microcode(struct psp_context *psp, 476 const char *chip_name); 477 int psp_init_ta_microcode(struct psp_context *psp, 478 const char *chip_name); 479 int psp_get_fw_attestation_records_addr(struct psp_context *psp, 480 uint64_t *output_ptr); 481 482 int psp_load_fw_list(struct psp_context *psp, 483 struct amdgpu_firmware_info **ucode_list, int ucode_count); 484 void psp_copy_fw(struct psp_context *psp, uint8_t *start_addr, uint32_t bin_size); 485 486 int is_psp_fw_valid(struct psp_bin_desc bin); 487 #endif 488