blob: 94e51670383c810e83f8b27c319c426e00c52415 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
/* 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 <ashish.kalra@amd.com>
*/
#ifndef __PSP_SFS_USER_H__
#define __PSP_SFS_USER_H__
#include <linux/types.h>
/**
* 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__ */
|
