drivers/gpu/drm/amd/amdgpu/amdgpu_psp.h - linux/torvalds/linux - Git at Google

 /*
  * Copyright 2016 Advanced Micro Devices, Inc.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a
  * copy of this software and associated documentation files (the "Software"),
  * to deal in the Software without restriction, including without limitation
  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  * and/or sell copies of the Software, and to permit persons to whom the
  * Software is furnished to do so, subject to the following conditions:
  *
  * The above copyright notice and this permission notice shall be included in
  * all copies or substantial portions of the Software.
  *
  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  * OTHER DEALINGS IN THE SOFTWARE.
  *
  * Author: Huang Rui
  *
  */
 #ifndef __AMDGPU_PSP_H__
 #define __AMDGPU_PSP_H__

 #include "amdgpu.h"
 #include "psp_gfx_if.h"
 #include "ta_xgmi_if.h"
 #include "ta_ras_if.h"

 #define PSP_FENCE_BUFFER_SIZE	0x1000
 #define PSP_CMD_BUFFER_SIZE	0x1000
 #define PSP_ASD_SHARED_MEM_SIZE 0x4000
 #define PSP_XGMI_SHARED_MEM_SIZE 0x4000
 #define PSP_RAS_SHARED_MEM_SIZE 0x4000
 #define PSP_1_MEG		0x100000
 #define PSP_TMR_SIZE	0x400000

 struct psp_context;
 struct psp_xgmi_node_info;
 struct psp_xgmi_topology_info;

 enum psp_bootloader_cmd {
 	PSP_BL__LOAD_SYSDRV		= 0x10000,
 	PSP_BL__LOAD_SOSDRV		= 0x20000,
 	PSP_BL__LOAD_KEY_DATABASE	= 0x80000,
 };

 enum psp_ring_type
 {
 	PSP_RING_TYPE__INVALID = 0,
 	/*
 	 * These values map to the way the PSP kernel identifies the
 	 * rings.
 	 */
 	PSP_RING_TYPE__UM = 1, /* User mode ring (formerly called RBI) */
 	PSP_RING_TYPE__KM = 2  /* Kernel mode ring (formerly called GPCOM) */
 };

 struct psp_ring
 {
 	enum psp_ring_type		ring_type;
 	struct psp_gfx_rb_frame		*ring_mem;
 	uint64_t			ring_mem_mc_addr;
 	void				*ring_mem_handle;
 	uint32_t			ring_size;
 };

 /* More registers may will be supported */
 enum psp_reg_prog_id {
 	PSP_REG_IH_RB_CNTL        = 0,  /* register IH_RB_CNTL */
 	PSP_REG_IH_RB_CNTL_RING1  = 1,  /* register IH_RB_CNTL_RING1 */
 	PSP_REG_IH_RB_CNTL_RING2  = 2,  /* register IH_RB_CNTL_RING2 */
 	PSP_REG_LAST
 };

 struct psp_funcs
 {
 	int (*init_microcode)(struct psp_context *psp);
 	int (*bootloader_load_kdb)(struct psp_context *psp);
 	int (*bootloader_load_sysdrv)(struct psp_context *psp);
 	int (*bootloader_load_sos)(struct psp_context *psp);
 	int (*ring_init)(struct psp_context *psp, enum psp_ring_type ring_type);
 	int (*ring_create)(struct psp_context *psp,
 			   enum psp_ring_type ring_type);
 	int (*ring_stop)(struct psp_context *psp,
 			    enum psp_ring_type ring_type);
 	int (*ring_destroy)(struct psp_context *psp,
 			    enum psp_ring_type ring_type);
 	int (*cmd_submit)(struct psp_context *psp,
 			  uint64_t cmd_buf_mc_addr, uint64_t fence_mc_addr,
 			  int index);
 	bool (*compare_sram_data)(struct psp_context *psp,
 				  struct amdgpu_firmware_info *ucode,
 				  enum AMDGPU_UCODE_ID ucode_type);
 	bool (*smu_reload_quirk)(struct psp_context *psp);
 	int (*mode1_reset)(struct psp_context *psp);
 	int (*xgmi_get_node_id)(struct psp_context *psp, uint64_t *node_id);
 	int (*xgmi_get_hive_id)(struct psp_context *psp, uint64_t *hive_id);
 	int (*xgmi_get_topology_info)(struct psp_context *psp, int number_devices,
 				      struct psp_xgmi_topology_info *topology);
 	int (*xgmi_set_topology_info)(struct psp_context *psp, int number_devices,
 				      struct psp_xgmi_topology_info *topology);
 	bool (*support_vmr_ring)(struct psp_context *psp);
 	int (*ras_trigger_error)(struct psp_context *psp,
 			struct ta_ras_trigger_error_input *info);
 	int (*ras_cure_posion)(struct psp_context *psp, uint64_t *mode_ptr);
 	int (*rlc_autoload_start)(struct psp_context *psp);
 };

 #define AMDGPU_XGMI_MAX_CONNECTED_NODES		64
 struct psp_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 psp_xgmi_topology_info {
 	uint32_t			num_nodes;
 	struct psp_xgmi_node_info	nodes[AMDGPU_XGMI_MAX_CONNECTED_NODES];
 };

 struct psp_xgmi_context {
 	uint8_t				initialized;
 	uint32_t			session_id;
 	struct amdgpu_bo                *xgmi_shared_bo;
 	uint64_t                        xgmi_shared_mc_addr;
 	void                            *xgmi_shared_buf;
 	struct psp_xgmi_topology_info	top_info;
 };

 struct psp_ras_context {
 	/*ras fw*/
 	bool			ras_initialized;
 	uint32_t		session_id;
 	struct amdgpu_bo	*ras_shared_bo;
 	uint64_t		ras_shared_mc_addr;
 	void			*ras_shared_buf;
 	struct amdgpu_ras	*ras;
 };

 struct psp_context
 {
 	struct amdgpu_device            *adev;
 	struct psp_ring                 km_ring;
 	struct psp_gfx_cmd_resp		*cmd;

 	const struct psp_funcs		*funcs;

 	/* firmware buffer */
 	struct amdgpu_bo		*fw_pri_bo;
 	uint64_t			fw_pri_mc_addr;
 	void				*fw_pri_buf;

 	/* sos firmware */
 	const struct firmware		*sos_fw;
 	uint32_t			sos_fw_version;
 	uint32_t			sos_feature_version;
 	uint32_t			sys_bin_size;
 	uint32_t			sos_bin_size;
 	uint32_t			toc_bin_size;
 	uint32_t			kdb_bin_size;
 	uint8_t				*sys_start_addr;
 	uint8_t				*sos_start_addr;
 	uint8_t				*toc_start_addr;
 	uint8_t				*kdb_start_addr;

 	/* tmr buffer */
 	struct amdgpu_bo		*tmr_bo;
 	uint64_t			tmr_mc_addr;

 	/* asd firmware and buffer */
 	const struct firmware		*asd_fw;
 	uint32_t			asd_fw_version;
 	uint32_t			asd_feature_version;
 	uint32_t			asd_ucode_size;
 	uint8_t				*asd_start_addr;
 	struct amdgpu_bo		*asd_shared_bo;
 	uint64_t			asd_shared_mc_addr;
 	void				*asd_shared_buf;

 	/* fence buffer */
 	struct amdgpu_bo		*fence_buf_bo;
 	uint64_t			fence_buf_mc_addr;
 	void				*fence_buf;

 	/* cmd buffer */
 	struct amdgpu_bo		*cmd_buf_bo;
 	uint64_t			cmd_buf_mc_addr;
 	struct psp_gfx_cmd_resp		*cmd_buf_mem;

 	/* fence value associated with cmd buffer */
 	atomic_t			fence_value;
 	/* flag to mark whether gfx fw autoload is supported or not */
 	bool				autoload_supported;

 	/* xgmi ta firmware and buffer */
 	const struct firmware		*ta_fw;
 	uint32_t			ta_fw_version;
 	uint32_t			ta_xgmi_ucode_version;
 	uint32_t			ta_xgmi_ucode_size;
 	uint8_t				*ta_xgmi_start_addr;
 	uint32_t			ta_ras_ucode_version;
 	uint32_t			ta_ras_ucode_size;
 	uint8_t				*ta_ras_start_addr;
 	struct psp_xgmi_context		xgmi_context;
 	struct psp_ras_context		ras;
 	struct mutex			mutex;
 };

 struct amdgpu_psp_funcs {
 	bool (*check_fw_loading_status)(struct amdgpu_device *adev,
 					enum AMDGPU_UCODE_ID);
 };


 #define psp_ring_init(psp, type) (psp)->funcs->ring_init((psp), (type))
 #define psp_ring_create(psp, type) (psp)->funcs->ring_create((psp), (type))
 #define psp_ring_stop(psp, type) (psp)->funcs->ring_stop((psp), (type))
 #define psp_ring_destroy(psp, type) ((psp)->funcs->ring_destroy((psp), (type)))
 #define psp_cmd_submit(psp, cmd_mc, fence_mc, index) \
 		(psp)->funcs->cmd_submit((psp), (cmd_mc), (fence_mc), (index))
 #define psp_compare_sram_data(psp, ucode, type) \
 		(psp)->funcs->compare_sram_data((psp), (ucode), (type))
 #define psp_init_microcode(psp) \
 		((psp)->funcs->init_microcode ? (psp)->funcs->init_microcode((psp)) : 0)
 #define psp_bootloader_load_kdb(psp) \
 		((psp)->funcs->bootloader_load_kdb ? (psp)->funcs->bootloader_load_kdb((psp)) : 0)
 #define psp_bootloader_load_sysdrv(psp) \
 		((psp)->funcs->bootloader_load_sysdrv ? (psp)->funcs->bootloader_load_sysdrv((psp)) : 0)
 #define psp_bootloader_load_sos(psp) \
 		((psp)->funcs->bootloader_load_sos ? (psp)->funcs->bootloader_load_sos((psp)) : 0)
 #define psp_smu_reload_quirk(psp) \
 		((psp)->funcs->smu_reload_quirk ? (psp)->funcs->smu_reload_quirk((psp)) : false)
 #define psp_support_vmr_ring(psp) \
 		((psp)->funcs->support_vmr_ring ? (psp)->funcs->support_vmr_ring((psp)) : false)
 #define psp_mode1_reset(psp) \
 		((psp)->funcs->mode1_reset ? (psp)->funcs->mode1_reset((psp)) : false)
 #define psp_xgmi_get_node_id(psp, node_id) \
 		((psp)->funcs->xgmi_get_node_id ? (psp)->funcs->xgmi_get_node_id((psp), (node_id)) : -EINVAL)
 #define psp_xgmi_get_hive_id(psp, hive_id) \
 		((psp)->funcs->xgmi_get_hive_id ? (psp)->funcs->xgmi_get_hive_id((psp), (hive_id)) : -EINVAL)
 #define psp_xgmi_get_topology_info(psp, num_device, topology) \
 		((psp)->funcs->xgmi_get_topology_info ? \
 		(psp)->funcs->xgmi_get_topology_info((psp), (num_device), (topology)) : -EINVAL)
 #define psp_xgmi_set_topology_info(psp, num_device, topology) \
 		((psp)->funcs->xgmi_set_topology_info ?	 \
 		(psp)->funcs->xgmi_set_topology_info((psp), (num_device), (topology)) : -EINVAL)
 #define psp_rlc_autoload(psp) \
 		((psp)->funcs->rlc_autoload_start ? (psp)->funcs->rlc_autoload_start((psp)) : 0)

 #define amdgpu_psp_check_fw_loading_status(adev, i) (adev)->firmware.funcs->check_fw_loading_status((adev), (i))

 #define psp_ras_trigger_error(psp, info) \
 	((psp)->funcs->ras_trigger_error ? \
 	(psp)->funcs->ras_trigger_error((psp), (info)) : -EINVAL)
 #define psp_ras_cure_posion(psp, addr) \
 	((psp)->funcs->ras_cure_posion ? \
 	(psp)->funcs->ras_cure_posion(psp, (addr)) : -EINVAL)

 extern const struct amd_ip_funcs psp_ip_funcs;

 extern const struct amdgpu_ip_block_version psp_v3_1_ip_block;
 extern int psp_wait_for(struct psp_context *psp, uint32_t reg_index,
 			uint32_t field_val, uint32_t mask, bool check_changed);

 extern const struct amdgpu_ip_block_version psp_v10_0_ip_block;
 extern const struct amdgpu_ip_block_version psp_v12_0_ip_block;

 int psp_gpu_reset(struct amdgpu_device *adev);
 int psp_update_vcn_sram(struct amdgpu_device *adev, int inst_idx,
 			uint64_t cmd_gpu_addr, int cmd_size);

 int psp_xgmi_invoke(struct psp_context *psp, uint32_t ta_cmd_id);

 int psp_ras_invoke(struct psp_context *psp, uint32_t ta_cmd_id);
 int psp_ras_enable_features(struct psp_context *psp,
 		union ta_ras_cmd_input *info, bool enable);

 int psp_rlc_autoload_start(struct psp_context *psp);

 extern const struct amdgpu_ip_block_version psp_v11_0_ip_block;
 int psp_reg_program(struct psp_context *psp, enum psp_reg_prog_id reg,
 		uint32_t value);
 #endif
	/*
	* Copyright 2016 Advanced Micro Devices, Inc.
	*
	* Permission is hereby granted, free of charge, to any person obtaining a
	* copy of this software and associated documentation files (the "Software"),
	* to deal in the Software without restriction, including without limitation
	* the rights to use, copy, modify, merge, publish, distribute, sublicense,
	* and/or sell copies of the Software, and to permit persons to whom the
	* Software is furnished to do so, subject to the following conditions:
	*
	* The above copyright notice and this permission notice shall be included in
	* all copies or substantial portions of the Software.
	*
	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
	* THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
	* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
	* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
	* OTHER DEALINGS IN THE SOFTWARE.
	*
	* Author: Huang Rui
	*
	*/
	#ifndef __AMDGPU_PSP_H__
	#define __AMDGPU_PSP_H__

	#include "amdgpu.h"
	#include "psp_gfx_if.h"
	#include "ta_xgmi_if.h"
	#include "ta_ras_if.h"

	#define PSP_FENCE_BUFFER_SIZE 0x1000
	#define PSP_CMD_BUFFER_SIZE 0x1000
	#define PSP_ASD_SHARED_MEM_SIZE 0x4000
	#define PSP_XGMI_SHARED_MEM_SIZE 0x4000
	#define PSP_RAS_SHARED_MEM_SIZE 0x4000
	#define PSP_1_MEG 0x100000
	#define PSP_TMR_SIZE 0x400000

	struct psp_context;
	struct psp_xgmi_node_info;
	struct psp_xgmi_topology_info;

	enum psp_bootloader_cmd {
	PSP_BL__LOAD_SYSDRV = 0x10000,
	PSP_BL__LOAD_SOSDRV = 0x20000,
	PSP_BL__LOAD_KEY_DATABASE = 0x80000,
	};

	enum psp_ring_type
	{
	PSP_RING_TYPE__INVALID = 0,
	/*
	* These values map to the way the PSP kernel identifies the
	* rings.
	*/
	PSP_RING_TYPE__UM = 1, /* User mode ring (formerly called RBI) */
	PSP_RING_TYPE__KM = 2 /* Kernel mode ring (formerly called GPCOM) */
	};

	struct psp_ring
	{
	enum psp_ring_type ring_type;
	struct psp_gfx_rb_frame *ring_mem;
	uint64_t ring_mem_mc_addr;
	void *ring_mem_handle;
	uint32_t ring_size;
	};

	/* More registers may will be supported */
	enum psp_reg_prog_id {
	PSP_REG_IH_RB_CNTL = 0, /* register IH_RB_CNTL */
	PSP_REG_IH_RB_CNTL_RING1 = 1, /* register IH_RB_CNTL_RING1 */
	PSP_REG_IH_RB_CNTL_RING2 = 2, /* register IH_RB_CNTL_RING2 */
	PSP_REG_LAST
	};

	struct psp_funcs
	{
	int (init_microcode)(struct psp_context psp);
	int (bootloader_load_kdb)(struct psp_context psp);
	int (bootloader_load_sysdrv)(struct psp_context psp);
	int (bootloader_load_sos)(struct psp_context psp);
	int (ring_init)(struct psp_context psp, enum psp_ring_type ring_type);
	int (ring_create)(struct psp_context psp,
	enum psp_ring_type ring_type);
	int (ring_stop)(struct psp_context psp,
	enum psp_ring_type ring_type);
	int (ring_destroy)(struct psp_context psp,
	enum psp_ring_type ring_type);
	int (cmd_submit)(struct psp_context psp,
	uint64_t cmd_buf_mc_addr, uint64_t fence_mc_addr,
	int index);
	bool (compare_sram_data)(struct psp_context psp,
	struct amdgpu_firmware_info *ucode,
	enum AMDGPU_UCODE_ID ucode_type);
	bool (smu_reload_quirk)(struct psp_context psp);
	int (mode1_reset)(struct psp_context psp);
	int (xgmi_get_node_id)(struct psp_context psp, uint64_t *node_id);
	int (xgmi_get_hive_id)(struct psp_context psp, uint64_t *hive_id);
	int (xgmi_get_topology_info)(struct psp_context psp, int number_devices,
	struct psp_xgmi_topology_info *topology);
	int (xgmi_set_topology_info)(struct psp_context psp, int number_devices,
	struct psp_xgmi_topology_info *topology);
	bool (support_vmr_ring)(struct psp_context psp);
	int (ras_trigger_error)(struct psp_context psp,
	struct ta_ras_trigger_error_input *info);
	int (ras_cure_posion)(struct psp_context psp, uint64_t *mode_ptr);
	int (rlc_autoload_start)(struct psp_context psp);
	};

	#define AMDGPU_XGMI_MAX_CONNECTED_NODES 64
	struct psp_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 psp_xgmi_topology_info {
	uint32_t num_nodes;
	struct psp_xgmi_node_info nodes[AMDGPU_XGMI_MAX_CONNECTED_NODES];
	};

	struct psp_xgmi_context {
	uint8_t initialized;
	uint32_t session_id;
	struct amdgpu_bo *xgmi_shared_bo;
	uint64_t xgmi_shared_mc_addr;
	void *xgmi_shared_buf;
	struct psp_xgmi_topology_info top_info;
	};

	struct psp_ras_context {
	/ras fw/
	bool ras_initialized;
	uint32_t session_id;
	struct amdgpu_bo *ras_shared_bo;
	uint64_t ras_shared_mc_addr;
	void *ras_shared_buf;
	struct amdgpu_ras *ras;
	};

	struct psp_context
	{
	struct amdgpu_device *adev;
	struct psp_ring km_ring;
	struct psp_gfx_cmd_resp *cmd;

	const struct psp_funcs *funcs;

	/* firmware buffer */
	struct amdgpu_bo *fw_pri_bo;
	uint64_t fw_pri_mc_addr;
	void *fw_pri_buf;

	/* sos firmware */
	const struct firmware *sos_fw;
	uint32_t sos_fw_version;
	uint32_t sos_feature_version;
	uint32_t sys_bin_size;
	uint32_t sos_bin_size;
	uint32_t toc_bin_size;
	uint32_t kdb_bin_size;
	uint8_t *sys_start_addr;
	uint8_t *sos_start_addr;
	uint8_t *toc_start_addr;
	uint8_t *kdb_start_addr;

	/* tmr buffer */
	struct amdgpu_bo *tmr_bo;
	uint64_t tmr_mc_addr;

	/* asd firmware and buffer */
	const struct firmware *asd_fw;
	uint32_t asd_fw_version;
	uint32_t asd_feature_version;
	uint32_t asd_ucode_size;
	uint8_t *asd_start_addr;
	struct amdgpu_bo *asd_shared_bo;
	uint64_t asd_shared_mc_addr;
	void *asd_shared_buf;

	/* fence buffer */
	struct amdgpu_bo *fence_buf_bo;
	uint64_t fence_buf_mc_addr;
	void *fence_buf;

	/* cmd buffer */
	struct amdgpu_bo *cmd_buf_bo;
	uint64_t cmd_buf_mc_addr;
	struct psp_gfx_cmd_resp *cmd_buf_mem;

	/* fence value associated with cmd buffer */
	atomic_t fence_value;
	/* flag to mark whether gfx fw autoload is supported or not */
	bool autoload_supported;

	/* xgmi ta firmware and buffer */
	const struct firmware *ta_fw;
	uint32_t ta_fw_version;
	uint32_t ta_xgmi_ucode_version;
	uint32_t ta_xgmi_ucode_size;
	uint8_t *ta_xgmi_start_addr;
	uint32_t ta_ras_ucode_version;
	uint32_t ta_ras_ucode_size;
	uint8_t *ta_ras_start_addr;
	struct psp_xgmi_context xgmi_context;
	struct psp_ras_context ras;
	struct mutex mutex;
	};

	struct amdgpu_psp_funcs {
	bool (check_fw_loading_status)(struct amdgpu_device adev,
	enum AMDGPU_UCODE_ID);
	};


	#define psp_ring_init(psp, type) (psp)->funcs->ring_init((psp), (type))
	#define psp_ring_create(psp, type) (psp)->funcs->ring_create((psp), (type))
	#define psp_ring_stop(psp, type) (psp)->funcs->ring_stop((psp), (type))
	#define psp_ring_destroy(psp, type) ((psp)->funcs->ring_destroy((psp), (type)))
	#define psp_cmd_submit(psp, cmd_mc, fence_mc, index) \
	(psp)->funcs->cmd_submit((psp), (cmd_mc), (fence_mc), (index))
	#define psp_compare_sram_data(psp, ucode, type) \
	(psp)->funcs->compare_sram_data((psp), (ucode), (type))
	#define psp_init_microcode(psp) \
	((psp)->funcs->init_microcode ? (psp)->funcs->init_microcode((psp)) : 0)
	#define psp_bootloader_load_kdb(psp) \
	((psp)->funcs->bootloader_load_kdb ? (psp)->funcs->bootloader_load_kdb((psp)) : 0)
	#define psp_bootloader_load_sysdrv(psp) \
	((psp)->funcs->bootloader_load_sysdrv ? (psp)->funcs->bootloader_load_sysdrv((psp)) : 0)
	#define psp_bootloader_load_sos(psp) \
	((psp)->funcs->bootloader_load_sos ? (psp)->funcs->bootloader_load_sos((psp)) : 0)
	#define psp_smu_reload_quirk(psp) \
	((psp)->funcs->smu_reload_quirk ? (psp)->funcs->smu_reload_quirk((psp)) : false)
	#define psp_support_vmr_ring(psp) \
	((psp)->funcs->support_vmr_ring ? (psp)->funcs->support_vmr_ring((psp)) : false)
	#define psp_mode1_reset(psp) \
	((psp)->funcs->mode1_reset ? (psp)->funcs->mode1_reset((psp)) : false)
	#define psp_xgmi_get_node_id(psp, node_id) \
	((psp)->funcs->xgmi_get_node_id ? (psp)->funcs->xgmi_get_node_id((psp), (node_id)) : -EINVAL)
	#define psp_xgmi_get_hive_id(psp, hive_id) \
	((psp)->funcs->xgmi_get_hive_id ? (psp)->funcs->xgmi_get_hive_id((psp), (hive_id)) : -EINVAL)
	#define psp_xgmi_get_topology_info(psp, num_device, topology) \
	((psp)->funcs->xgmi_get_topology_info ? \
	(psp)->funcs->xgmi_get_topology_info((psp), (num_device), (topology)) : -EINVAL)
	#define psp_xgmi_set_topology_info(psp, num_device, topology) \
	((psp)->funcs->xgmi_set_topology_info ? \
	(psp)->funcs->xgmi_set_topology_info((psp), (num_device), (topology)) : -EINVAL)
	#define psp_rlc_autoload(psp) \
	((psp)->funcs->rlc_autoload_start ? (psp)->funcs->rlc_autoload_start((psp)) : 0)

	#define amdgpu_psp_check_fw_loading_status(adev, i) (adev)->firmware.funcs->check_fw_loading_status((adev), (i))

	#define psp_ras_trigger_error(psp, info) \
	((psp)->funcs->ras_trigger_error ? \
	(psp)->funcs->ras_trigger_error((psp), (info)) : -EINVAL)
	#define psp_ras_cure_posion(psp, addr) \
	((psp)->funcs->ras_cure_posion ? \
	(psp)->funcs->ras_cure_posion(psp, (addr)) : -EINVAL)

	extern const struct amd_ip_funcs psp_ip_funcs;

	extern const struct amdgpu_ip_block_version psp_v3_1_ip_block;
	extern int psp_wait_for(struct psp_context *psp, uint32_t reg_index,
	uint32_t field_val, uint32_t mask, bool check_changed);

	extern const struct amdgpu_ip_block_version psp_v10_0_ip_block;
	extern const struct amdgpu_ip_block_version psp_v12_0_ip_block;

	int psp_gpu_reset(struct amdgpu_device *adev);
	int psp_update_vcn_sram(struct amdgpu_device *adev, int inst_idx,
	uint64_t cmd_gpu_addr, int cmd_size);

	int psp_xgmi_invoke(struct psp_context *psp, uint32_t ta_cmd_id);

	int psp_ras_invoke(struct psp_context *psp, uint32_t ta_cmd_id);
	int psp_ras_enable_features(struct psp_context *psp,
	union ta_ras_cmd_input *info, bool enable);

	int psp_rlc_autoload_start(struct psp_context *psp);

	extern const struct amdgpu_ip_block_version psp_v11_0_ip_block;
	int psp_reg_program(struct psp_context *psp, enum psp_reg_prog_id reg,
	uint32_t value);
	#endif