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
8enum 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
17struct psp_req_buffer_hdr {
18 u32 payload_size;
19 u32 status;
20} __packed;
21
22struct 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 */
40int 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 */
55int 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 */
67int psp_check_platform_access_status(void);
68
69#endif /* __PSP_PLATFORM_ACCESS_H */
70

source code of linux/include/linux/psp-platform-access.h