1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2
3 #ifndef __QCOM_FASTRPC_H__
4 #define __QCOM_FASTRPC_H__
5
6 #include <linux/types.h>
7
8 #define FASTRPC_IOCTL_ALLOC_DMA_BUFF _IOWR('R', 1, struct fastrpc_alloc_dma_buf)
9 #define FASTRPC_IOCTL_FREE_DMA_BUFF _IOWR('R', 2, __u32)
10 #define FASTRPC_IOCTL_INVOKE _IOWR('R', 3, struct fastrpc_invoke)
11 #define FASTRPC_IOCTL_INIT_ATTACH _IO('R', 4)
12 #define FASTRPC_IOCTL_INIT_CREATE _IOWR('R', 5, struct fastrpc_init_create)
13 #define FASTRPC_IOCTL_MMAP _IOWR('R', 6, struct fastrpc_req_mmap)
14 #define FASTRPC_IOCTL_MUNMAP _IOWR('R', 7, struct fastrpc_req_munmap)
15 #define FASTRPC_IOCTL_INIT_ATTACH_SNS _IO('R', 8)
16 #define FASTRPC_IOCTL_INIT_CREATE_STATIC _IOWR('R', 9, struct fastrpc_init_create_static)
17 #define FASTRPC_IOCTL_MEM_MAP _IOWR('R', 10, struct fastrpc_mem_map)
18 #define FASTRPC_IOCTL_MEM_UNMAP _IOWR('R', 11, struct fastrpc_mem_unmap)
19 #define FASTRPC_IOCTL_GET_DSP_INFO _IOWR('R', 13, struct fastrpc_ioctl_capability)
20
21 /**
22 * enum fastrpc_map_flags - control flags for mapping memory on DSP user process
23 * @FASTRPC_MAP_STATIC: Map memory pages with RW- permission and CACHE WRITEBACK.
24 * The driver is responsible for cache maintenance when passed
25 * the buffer to FastRPC calls. Same virtual address will be
26 * assigned for subsequent FastRPC calls.
27 * @FASTRPC_MAP_RESERVED: Reserved
28 * @FASTRPC_MAP_FD: Map memory pages with RW- permission and CACHE WRITEBACK.
29 * Mapping tagged with a file descriptor. User is responsible for
30 * CPU and DSP cache maintenance for the buffer. Get virtual address
31 * of buffer on DSP using HAP_mmap_get() and HAP_mmap_put() APIs.
32 * @FASTRPC_MAP_FD_DELAYED: Mapping delayed until user call HAP_mmap() and HAP_munmap()
33 * functions on DSP. It is useful to map a buffer with cache modes
34 * other than default modes. User is responsible for CPU and DSP
35 * cache maintenance for the buffer.
36 * @FASTRPC_MAP_FD_NOMAP: This flag is used to skip CPU mapping,
37 * otherwise behaves similar to FASTRPC_MAP_FD_DELAYED flag.
38 * @FASTRPC_MAP_MAX: max count for flags
39 *
40 */
41 enum fastrpc_map_flags {
42 FASTRPC_MAP_STATIC = 0,
43 FASTRPC_MAP_RESERVED,
44 FASTRPC_MAP_FD = 2,
45 FASTRPC_MAP_FD_DELAYED,
46 FASTRPC_MAP_FD_NOMAP = 16,
47 FASTRPC_MAP_MAX,
48 };
49
50 enum fastrpc_proc_attr {
51 /* Macro for Debug attr */
52 FASTRPC_MODE_DEBUG = (1 << 0),
53 /* Macro for Ptrace */
54 FASTRPC_MODE_PTRACE = (1 << 1),
55 /* Macro for CRC Check */
56 FASTRPC_MODE_CRC = (1 << 2),
57 /* Macro for Unsigned PD */
58 FASTRPC_MODE_UNSIGNED_MODULE = (1 << 3),
59 /* Macro for Adaptive QoS */
60 FASTRPC_MODE_ADAPTIVE_QOS = (1 << 4),
61 /* Macro for System Process */
62 FASTRPC_MODE_SYSTEM_PROCESS = (1 << 5),
63 /* Macro for Prvileged Process */
64 FASTRPC_MODE_PRIVILEGED = (1 << 6),
65 };
66
67 /* Fastrpc attribute for memory protection of buffers */
68 #define FASTRPC_ATTR_SECUREMAP (1)
69
70 struct fastrpc_invoke_args {
71 __u64 ptr;
72 __u64 length;
73 __s32 fd;
74 __u32 attr;
75 };
76
77 struct fastrpc_invoke {
78 __u32 handle;
79 __u32 sc;
80 __u64 args;
81 };
82
83 struct fastrpc_init_create {
84 __u32 filelen; /* elf file length */
85 __s32 filefd; /* fd for the file */
86 __u32 attrs;
87 __u32 siglen;
88 __u64 file; /* pointer to elf file */
89 };
90
91 struct fastrpc_init_create_static {
92 __u32 namelen; /* length of pd process name */
93 __u32 memlen;
94 __u64 name; /* pd process name */
95 };
96
97 struct fastrpc_alloc_dma_buf {
98 __s32 fd; /* fd */
99 __u32 flags; /* flags to map with */
100 __u64 size; /* size */
101 };
102
103 struct fastrpc_req_mmap {
104 __s32 fd;
105 __u32 flags; /* flags for dsp to map with */
106 __u64 vaddrin; /* optional virtual address */
107 __u64 size; /* size */
108 __u64 vaddrout; /* dsp virtual address */
109 };
110
111 struct fastrpc_mem_map {
112 __s32 version;
113 __s32 fd; /* fd */
114 __s32 offset; /* buffer offset */
115 __u32 flags; /* flags defined in enum fastrpc_map_flags */
116 __u64 vaddrin; /* buffer virtual address */
117 __u64 length; /* buffer length */
118 __u64 vaddrout; /* [out] remote virtual address */
119 __s32 attrs; /* buffer attributes used for SMMU mapping */
120 __s32 reserved[4];
121 };
122
123 struct fastrpc_req_munmap {
124 __u64 vaddrout; /* address to unmap */
125 __u64 size; /* size */
126 };
127
128 struct fastrpc_mem_unmap {
129 __s32 vesion;
130 __s32 fd; /* fd */
131 __u64 vaddr; /* remote process (dsp) virtual address */
132 __u64 length; /* buffer size */
133 __s32 reserved[5];
134 };
135
136 struct fastrpc_ioctl_capability {
137 __u32 domain;
138 __u32 attribute_id;
139 __u32 capability; /* dsp capability */
140 __u32 reserved[4];
141 };
142
143 #endif /* __QCOM_FASTRPC_H__ */
144
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.