include/uapi/misc/fastrpc.h

   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__ */