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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
/* SPDX-License-Identifier: GPL-2.0-only WITH Linux-syscall-note */
/*
* Userspace interface for AMD Dynamic Boost Control (DBC)
*
* Copyright (C) 2023 Advanced Micro Devices, Inc.
*
* Author: Mario Limonciello <mario.limonciello@amd.com>
*/
#ifndef __PSP_DBC_USER_H__
#define __PSP_DBC_USER_H__
#include <linux/types.h>
/**
* DOC: AMD Dynamic Boost Control (DBC) interface
*/
#define DBC_NONCE_SIZE 16
#define DBC_SIG_SIZE 32
#define DBC_UID_SIZE 16
/**
* struct dbc_user_nonce - Nonce exchange structure (input/output).
* @auth_needed: Whether the PSP should authenticate this request (input).
* 0: no authentication, PSP will return single use nonce.
* 1: authentication: PSP will return multi-use nonce.
* @nonce: 8 byte value used for future authentication (output).
* @signature: Optional 32 byte signature created by software using a
* previous nonce (input).
*/
struct dbc_user_nonce {
__u32 auth_needed;
__u8 nonce[DBC_NONCE_SIZE];
__u8 signature[DBC_SIG_SIZE];
} __packed;
/**
* struct dbc_user_setuid - UID exchange structure (input).
* @uid: 16 byte value representing software identity
* @signature: 32 byte signature created by software using a previous nonce
*/
struct dbc_user_setuid {
__u8 uid[DBC_UID_SIZE];
__u8 signature[DBC_SIG_SIZE];
} __packed;
/**
* struct dbc_user_param - Parameter exchange structure (input/output).
* @msg_index: Message indicating what parameter to set or get (input)
* @param: 4 byte parameter, units are message specific. (input/output)
* @signature: 32 byte signature.
* - When sending a message this is to be created by software
* using a previous nonce (input)
* - For interpreting results, this signature is updated by the
* PSP to allow software to validate the authenticity of the
* results.
*/
struct dbc_user_param {
__u32 msg_index;
__u32 param;
__u8 signature[DBC_SIG_SIZE];
} __packed;
/**
* Dynamic Boost Control (DBC) IOC
*
* possible return codes for all DBC 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: unknown error
*/
#define DBC_IOC_TYPE 'D'
/**
* DBCIOCNONCE - Fetch a nonce from the PSP for authenticating commands.
* If a nonce is fetched without authentication it can only
* be utilized for one command.
* If a nonce is fetched with authentication it can be used
* for multiple requests.
*/
#define DBCIOCNONCE _IOWR(DBC_IOC_TYPE, 0x1, struct dbc_user_nonce)
/**
* DBCIOCUID - Set the user ID (UID) of a calling process.
* The user ID is 8 bytes long. It must be programmed using a
* 32 byte signature built using the nonce fetched from
* DBCIOCNONCE.
* The UID can only be set once until the system is rebooted.
*/
#define DBCIOCUID _IOW(DBC_IOC_TYPE, 0x2, struct dbc_user_setuid)
/**
* DBCIOCPARAM - Set or get a parameter from the PSP.
* This request will only work after DBCIOCUID has successfully
* set the UID of the calling process.
* Whether the parameter is set or get is controlled by the
* message ID in the request.
* This command must be sent using a 32 byte signature built
* using the nonce fetched from DBCIOCNONCE.
* When the command succeeds, the 32 byte signature will be
* updated by the PSP for software to authenticate the results.
*/
#define DBCIOCPARAM _IOWR(DBC_IOC_TYPE, 0x3, struct dbc_user_param)
/**
* enum dbc_cmd_msg - Messages utilized by DBCIOCPARAM
* @PARAM_GET_FMAX_CAP: Get frequency cap (MHz)
* @PARAM_SET_FMAX_CAP: Set frequency cap (MHz)
* @PARAM_GET_PWR_CAP: Get socket power cap (mW)
* @PARAM_SET_PWR_CAP: Set socket power cap (mW)
* @PARAM_GET_GFX_MODE: Get graphics mode (0/1)
* @PARAM_SET_GFX_MODE: Set graphics mode (0/1)
* @PARAM_GET_CURR_TEMP: Get current temperature (degrees C)
* @PARAM_GET_FMAX_MAX: Get maximum allowed value for frequency (MHz)
* @PARAM_GET_FMAX_MIN: Get minimum allowed value for frequency (MHz)
* @PARAM_GET_SOC_PWR_MAX: Get maximum allowed value for SoC power (mw)
* @PARAM_GET_SOC_PWR_MIN: Get minimum allowed value for SoC power (mw)
* @PARAM_GET_SOC_PWR_CUR: Get current value for SoC Power (mW)
*/
enum dbc_cmd_msg {
PARAM_GET_FMAX_CAP = 0x3,
PARAM_SET_FMAX_CAP = 0x4,
PARAM_GET_PWR_CAP = 0x5,
PARAM_SET_PWR_CAP = 0x6,
PARAM_GET_GFX_MODE = 0x7,
PARAM_SET_GFX_MODE = 0x8,
PARAM_GET_CURR_TEMP = 0x9,
PARAM_GET_FMAX_MAX = 0xA,
PARAM_GET_FMAX_MIN = 0xB,
PARAM_GET_SOC_PWR_MAX = 0xC,
PARAM_GET_SOC_PWR_MIN = 0xD,
PARAM_GET_SOC_PWR_CUR = 0xE,
};
#endif /* __PSP_DBC_USER_H__ */
|
