1 /** 2 * Copyright (c) 2019, The Linux Foundation. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions are 6 * met: 7 * * Redistributions of source code must retain the above copyright 8 * notice, this list of conditions and the following disclaimer. 9 * * Redistributions in binary form must reproduce the above 10 * copyright notice, this list of conditions and the following 11 * disclaimer in the documentation and/or other materials provided 12 * with the distribution. 13 * * Neither the name of The Linux Foundation nor the names of its 14 * contributors may be used to endorse or promote products derived 15 * from this software without specific prior written permission. 16 * 17 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED 18 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 19 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT 20 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS 21 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR 24 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 25 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 26 * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN 27 * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28 */ 29 30 #ifndef _ADSP_CURRENT_PROCESS1_H 31 #define _ADSP_CURRENT_PROCESS1_H 32 #include "remote.h" 33 #ifndef __QAIC_HEADER 34 #define __QAIC_HEADER(ff) ff 35 #endif //__QAIC_HEADER 36 37 #ifndef __QAIC_HEADER_EXPORT 38 #define __QAIC_HEADER_EXPORT 39 #endif // __QAIC_HEADER_EXPORT 40 41 #ifndef __QAIC_HEADER_ATTRIBUTE 42 #define __QAIC_HEADER_ATTRIBUTE 43 #endif // __QAIC_HEADER_ATTRIBUTE 44 45 #ifndef __QAIC_IMPL 46 #define __QAIC_IMPL(ff) ff 47 #endif //__QAIC_IMPL 48 49 #ifndef __QAIC_IMPL_EXPORT 50 #define __QAIC_IMPL_EXPORT 51 #endif // __QAIC_IMPL_EXPORT 52 53 #ifndef __QAIC_IMPL_ATTRIBUTE 54 #define __QAIC_IMPL_ATTRIBUTE 55 #endif // __QAIC_IMPL_ATTRIBUTE 56 #ifdef __cplusplus 57 extern "C" { 58 #endif 59 #if !defined(__QAIC_STRING1_OBJECT_DEFINED__) && !defined(__STRING1_OBJECT__) 60 #define __QAIC_STRING1_OBJECT_DEFINED__ 61 #define __STRING1_OBJECT__ 62 typedef struct _cstring1_s { 63 char* data; 64 int dataLen; 65 } _cstring1_t; 66 67 #endif /* __QAIC_STRING1_OBJECT_DEFINED__ */ 68 #define _const_adsp_current_process1_handle 4 69 /** 70 * Opens the handle in the specified domain. If this is the first 71 * handle, this creates the session. Typically this means opening 72 * the device, aka open("/dev/adsprpc-smd"), then calling ioctl 73 * device APIs to create a PD on the DSP to execute our code in, 74 * then asking that PD to dlopen the .so and dlsym the skel function. 75 * 76 * @param uri, <interface>_URI"&_dom=aDSP" 77 * <interface>_URI is a QAIC generated uri, or 78 * "file:///<sofilename>?<interface>_skel_handle_invoke&_modver=1.0" 79 * If the _dom parameter is not present, _dom=DEFAULT is assumed 80 * but not forwarded. 81 * Reserved uri keys: 82 * [0]: first unamed argument is the skel invoke function 83 * _dom: execution domain name, _dom=mDSP/aDSP/DEFAULT 84 * _modver: module version, _modver=1.0 85 * _*: any other key name starting with an _ is reserved 86 * Unknown uri keys/values are forwarded as is. 87 * @param h, resulting handle 88 * @retval, 0 on success 89 */ 90 __QAIC_HEADER_EXPORT int __QAIC_HEADER(adsp_current_process1_open)(const char* uri, remote_handle64* h) __QAIC_HEADER_ATTRIBUTE; 91 /** 92 * Closes a handle. If this is the last handle to close, the session 93 * is closed as well, releasing all the allocated resources. 94 95 * @param h, the handle to close 96 * @retval, 0 on success, should always succeed 97 */ 98 __QAIC_HEADER_EXPORT int __QAIC_HEADER(adsp_current_process1_close)(remote_handle64 h) __QAIC_HEADER_ATTRIBUTE; 99 __QAIC_HEADER_EXPORT int __QAIC_HEADER(adsp_current_process1_exit)(remote_handle64 _h) __QAIC_HEADER_ATTRIBUTE; 100 __QAIC_HEADER_EXPORT int __QAIC_HEADER(adsp_current_process1_thread_exit)(remote_handle64 _h) __QAIC_HEADER_ATTRIBUTE; 101 __QAIC_HEADER_EXPORT int __QAIC_HEADER(adsp_current_process1_set_logging_params)(remote_handle64 _h, unsigned short mask, const _cstring1_t* filesToLog, int filesToLogLen) __QAIC_HEADER_ATTRIBUTE; 102 __QAIC_HEADER_EXPORT int __QAIC_HEADER(adsp_current_process1_getASID)(remote_handle64 _h, unsigned int* asid) __QAIC_HEADER_ATTRIBUTE; 103 #ifndef adsp_current_process1_URI 104 #define adsp_current_process1_URI "file:///libadsp_current_process1_skel.so?adsp_current_process1_skel_handle_invoke&_modver=1.0" 105 #endif /*adsp_current_process1_URI*/ 106 #ifdef __cplusplus 107 } 108 #endif 109 #endif //_ADSP_CURRENT_PROCESS1_H 110