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_I2C_REQ_BUS_CMD = 0x64,
11 	PSP_DYNAMIC_BOOST_GET_NONCE,
12 	PSP_DYNAMIC_BOOST_SET_UID,
13 	PSP_DYNAMIC_BOOST_GET_PARAMETER,
14 	PSP_DYNAMIC_BOOST_SET_PARAMETER,
15 };
16 
17 struct psp_req_buffer_hdr {
18 	u32 payload_size;
19 	u32 status;
20 } __packed;
21 
22 struct psp_request {
23 	struct psp_req_buffer_hdr header;
24 	void *buf;
25 } __packed;
26 
27 /**
28  * psp_send_platform_access_msg() - Send a message to control platform features
29  *
30  * This function is intended to be used by drivers outside of ccp to communicate
31  * with the platform.
32  *
33  * Returns:
34  *  0:           success
35  *  -%EBUSY:     mailbox in recovery or in use
36  *  -%ENODEV:    driver not bound with PSP device
37  *  -%ETIMEDOUT: request timed out
38  *  -%EIO:       unknown error (see kernel log)
39  */
40 int psp_send_platform_access_msg(enum psp_platform_access_msg, struct psp_request *req);
41 
42 /**
43  * psp_ring_platform_doorbell() - Ring platform doorbell
44  *
45  * This function is intended to be used by drivers outside of ccp to ring the
46  * platform doorbell with a message.
47  *
48  * Returns:
49  *  0:           success
50  *  -%EBUSY:     mailbox in recovery or in use
51  *  -%ENODEV:    driver not bound with PSP device
52  *  -%ETIMEDOUT: request timed out
53  *  -%EIO:       error will be stored in result argument
54  */
55 int psp_ring_platform_doorbell(int msg, u32 *result);
56 
57 /**
58  * psp_check_platform_access_status() - Checks whether platform features is ready
59  *
60  * This function is intended to be used by drivers outside of ccp to determine
61  * if platform features has initialized.
62  *
63  * Returns:
64  * 0          platform features is ready
65  * -%ENODEV   platform features is not ready or present
66  */
67 int psp_check_platform_access_status(void);
68 
69 #endif /* __PSP_PLATFORM_ACCESS_H */
70