1 /* SPDX-License-Identifier: GPL-2.0-only */
2
3 #ifndef __PSP_PLATFORM_ACCESS_H
4 #define __PSP_PLATFORM_ACCESS_H
5
6 #include <linux/psp.h>
7
8 enum psp_platform_access_msg {
9 PSP_CMD_NONE = 0x0,
10 PSP_CMD_HSTI_QUERY = 0x14,
11 PSP_I2C_REQ_BUS_CMD = 0x64,
12 PSP_DYNAMIC_BOOST_GET_NONCE,
13 PSP_DYNAMIC_BOOST_SET_UID,
14 PSP_DYNAMIC_BOOST_GET_PARAMETER,
15 PSP_DYNAMIC_BOOST_SET_PARAMETER,
16 };
17
18 struct psp_req_buffer_hdr {
19 u32 payload_size;
20 u32 status;
21 } __packed;
22
23 struct psp_request {
24 struct psp_req_buffer_hdr header;
25 void *buf;
26 } __packed;
27
28 /**
29 * psp_send_platform_access_msg() - Send a message to control platform features
30 *
31 * This function is intended to be used by drivers outside of ccp to communicate
32 * with the platform.
33 *
34 * Returns:
35 * 0: success
36 * -%EBUSY: mailbox in recovery or in use
37 * -%ENODEV: driver not bound with PSP device
38 * -%ETIMEDOUT: request timed out
39 * -%EIO: unknown error (see kernel log)
40 */
41 int psp_send_platform_access_msg(enum psp_platform_access_msg, struct psp_request *req);
42
43 /**
44 * psp_ring_platform_doorbell() - Ring platform doorbell
45 *
46 * This function is intended to be used by drivers outside of ccp to ring the
47 * platform doorbell with a message.
48 *
49 * Returns:
50 * 0: success
51 * -%EBUSY: mailbox in recovery or in use
52 * -%ENODEV: driver not bound with PSP device
53 * -%ETIMEDOUT: request timed out
54 * -%EIO: error will be stored in result argument
55 */
56 int psp_ring_platform_doorbell(int msg, u32 *result);
57
58 /**
59 * psp_check_platform_access_status() - Checks whether platform features is ready
60 *
61 * This function is intended to be used by drivers outside of ccp to determine
62 * if platform features has initialized.
63 *
64 * Returns:
65 * 0 platform features is ready
66 * -%ENODEV platform features is not ready or present
67 */
68 int psp_check_platform_access_status(void);
69
70 #endif /* __PSP_PLATFORM_ACCESS_H */
71
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.