/* SPDX-License-Identifier: GPL-2.0-only WITH Linux-syscall-note */ /* * Userspace interface for AMD Seamless Firmware Servicing (SFS) * * Copyright (C) 2025 Advanced Micro Devices, Inc. * * Author: Ashish Kalra */ #ifndef __PSP_SFS_USER_H__ #define __PSP_SFS_USER_H__ #include /** * SFS: AMD Seamless Firmware Support (SFS) interface */ #define PAYLOAD_NAME_SIZE 64 #define TEE_EXT_CMD_BUFFER_SIZE 4096 /** * struct sfs_user_get_fw_versions - get current level of base firmware (output). * @blob: current level of base firmware for ASP and patch levels (input/output). * @sfs_status: 32-bit SFS status value (output). * @sfs_extended_status: 32-bit SFS extended status value (output). */ struct sfs_user_get_fw_versions { __u8 blob[TEE_EXT_CMD_BUFFER_SIZE]; __u32 sfs_status; __u32 sfs_extended_status; } __packed; /** * struct sfs_user_update_package - update SFS package (input). * @payload_name: name of SFS package to load, verify and execute (input). * @sfs_status: 32-bit SFS status value (output). * @sfs_extended_status: 32-bit SFS extended status value (output). */ struct sfs_user_update_package { char payload_name[PAYLOAD_NAME_SIZE]; __u32 sfs_status; __u32 sfs_extended_status; } __packed; /** * Seamless Firmware Support (SFS) IOC * * possible return codes for all SFS IOCTLs: * 0: success * -EINVAL: invalid input * -E2BIG: excess data passed * -EFAULT: failed to copy to/from userspace * -EBUSY: mailbox in recovery or in use * -ENODEV: driver not bound with PSP device * -EACCES: request isn't authorized * -EINVAL: invalid parameter * -ETIMEDOUT: request timed out * -EAGAIN: invalid request for state machine * -ENOENT: not implemented * -ENFILE: overflow * -EPERM: invalid signature * -EIO: PSP I/O error */ #define SFS_IOC_TYPE 'S' /** * SFSIOCFWVERS - returns blob containing FW versions * ASP provides the current level of Base Firmware for the ASP * and the other microprocessors as well as current patch * level(s). */ #define SFSIOCFWVERS _IOWR(SFS_IOC_TYPE, 0x1, struct sfs_user_get_fw_versions) /** * SFSIOCUPDATEPKG - updates package/payload * ASP loads, verifies and executes the SFS package. * By default, the SFS package/payload is loaded from * /lib/firmware/amd, but alternative firmware loading * path can be specified using kernel parameter * firmware_class.path or the firmware loading path * can be customized using sysfs file: * /sys/module/firmware_class/parameters/path. */ #define SFSIOCUPDATEPKG _IOWR(SFS_IOC_TYPE, 0x2, struct sfs_user_update_package) #endif /* __PSP_SFS_USER_H__ */