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 */
 41enum 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
 50enum 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
 70struct fastrpc_invoke_args {
 71	__u64 ptr;
 72	__u64 length;
 73	__s32 fd;
 74	__u32 attr;
 75};
 76
 77struct fastrpc_invoke {
 78	__u32 handle;
 79	__u32 sc;
 80	__u64 args;
 81};
 82
 83struct 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
 91struct fastrpc_init_create_static {
 92	__u32 namelen;	/* length of pd process name */
 93	__u32 memlen;
 94	__u64 name;	/* pd process name */
 95};
 96
 97struct fastrpc_alloc_dma_buf {
 98	__s32 fd;	/* fd */
 99	__u32 flags;	/* flags to map with */
100	__u64 size;	/* size */
101};
102
103struct 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
111struct 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
123struct fastrpc_req_munmap {
124	__u64 vaddrout;	/* address to unmap */
125	__u64 size;	/* size */
126};
127
128struct 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
136struct 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__ */