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