xref: /linux/include/linux/firmware/imx/ipc.h (revision b83deaa741558babf4b8d51d34f6637ccfff1b26)
1 /* SPDX-License-Identifier: GPL-2.0+ */
2 /*
3  * Copyright 2018 NXP
4  *
5  * Header file for the IPC implementation.
6  */
7 
8 #ifndef _SC_IPC_H
9 #define _SC_IPC_H
10 
11 #include <linux/device.h>
12 #include <linux/types.h>
13 
14 #define IMX_SC_RPC_VERSION	1
15 #define IMX_SC_RPC_MAX_MSG	8
16 
17 struct imx_sc_ipc;
18 
19 enum imx_sc_rpc_svc {
20 	IMX_SC_RPC_SVC_UNKNOWN = 0,
21 	IMX_SC_RPC_SVC_RETURN = 1,
22 	IMX_SC_RPC_SVC_PM = 2,
23 	IMX_SC_RPC_SVC_RM = 3,
24 	IMX_SC_RPC_SVC_TIMER = 5,
25 	IMX_SC_RPC_SVC_PAD = 6,
26 	IMX_SC_RPC_SVC_MISC = 7,
27 	IMX_SC_RPC_SVC_IRQ = 8,
28 };
29 
30 struct imx_sc_rpc_msg {
31 	uint8_t ver;
32 	uint8_t size;
33 	uint8_t svc;
34 	uint8_t func;
35 };
36 
37 #ifdef CONFIG_IMX_SCU
38 /*
39  * This is an function to send an RPC message over an IPC channel.
40  * It is called by client-side SCFW API function shims.
41  *
42  * @param[in]     ipc         IPC handle
43  * @param[in,out] msg         handle to a message
44  * @param[in]     have_resp   response flag
45  *
46  * If have_resp is true then this function waits for a response
47  * and returns the result in msg.
48  */
49 int imx_scu_call_rpc(struct imx_sc_ipc *ipc, void *msg, bool have_resp);
50 
51 /*
52  * This function gets the default ipc handle used by SCU
53  *
54  * @param[out]	ipc	sc ipc handle
55  *
56  * @return Returns an error code (0 = success, failed if < 0)
57  */
58 int imx_scu_get_handle(struct imx_sc_ipc **ipc);
59 #else
60 static inline int imx_scu_call_rpc(struct imx_sc_ipc *ipc, void *msg,
61 				   bool have_resp)
62 {
63 	return -ENOTSUPP;
64 }
65 
66 static inline int imx_scu_get_handle(struct imx_sc_ipc **ipc)
67 {
68 	return -ENOTSUPP;
69 }
70 #endif
71 #endif /* _SC_IPC_H */
72