b21cec1443672a0cd208537c5972d66b833c72f5
[ipc/ipcdev.git] / linux / include / _lad.h
1 /*
2  * Copyright (c) 2012-2015 Texas Instruments Incorporated - http://www.ti.com
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * *  Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  *
12  * *  Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * *  Neither the name of Texas Instruments Incorporated nor the names of
17  *    its contributors may be used to endorse or promote products derived
18  *    from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
22  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
24  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
26  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
27  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
28  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
29  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
30  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  */
32 /*
33  *  ======== _lad.h ========
34  */
36 #ifndef _lad_
37 #define _lad_
39 #ifdef __cplusplus
40 extern "C" {
41 #endif
43 #include <ti/ipc/MessageQ.h>
44 #include <_MessageQ.h>
45 #include <ti/ipc/NameServer.h>
46 #include <ti/ipc/MultiProc.h>
47 #include <_MultiProc.h>
48 #include <stdio.h>
49 #include <ti/ipc/GateMP.h>
50 #include <_GateMP.h>
51 #include <_Ipc.h>
52 #include <GateHWSpinlock.h>
53 #include <sys/time.h>
54 #include <ti/ipc/namesrv/_NameServerRemoteRpmsg.h>
56 extern Bool logFile;
57 extern FILE *logPtr;
58 extern struct timeval start_tv;
60 /*
61  * Macros for writing to log file.
62  *
63  * For the timestamp prefix, subtract the start time (which is established
64  * when the logFile is opened) so that the massive "since the epoch" value
65  * is not displayed.  For this, subtract only the timeval.tv_sec (seconds)
66  * value so we don't have to worry about the "borrow" that results when
67  * start_tv.tv_usec > tv.tv_usec.
68  */
69 #define LOG0(a)  \
70     if (logFile == TRUE) { \
71         struct timeval tv; \
72         gettimeofday(&tv, NULL); \
73         fprintf(logPtr, "[%d.%06d] " a, \
74                 (unsigned int)(tv.tv_sec - start_tv.tv_sec), \
75                 (unsigned int)tv.tv_usec); \
76         fflush(logPtr); \
77     }
79 #define LOG1(a, b)  \
80     if (logFile == TRUE) { \
81         struct timeval tv; \
82         gettimeofday(&tv, NULL); \
83         fprintf(logPtr, "[%d.%06d] " a, \
84                 (unsigned int)(tv.tv_sec - start_tv.tv_sec), \
85                 (unsigned int)tv.tv_usec, b); \
86         fflush(logPtr); \
87     }
89 #define LOG2(a, b, c)  \
90     if (logFile == TRUE) { \
91         struct timeval tv; \
92         gettimeofday(&tv, NULL); \
93         fprintf(logPtr, "[%d.%06d] " a, \
94                 (unsigned int)(tv.tv_sec - start_tv.tv_sec), \
95                 (unsigned int)tv.tv_usec, b, c); \
96         fflush(logPtr); \
97     }
99 #define LOG3(a, b, c, d)  \
100     if (logFile == TRUE) { \
101         struct timeval tv; \
102         gettimeofday(&tv, NULL); \
103         fprintf(logPtr, "[%d.%06d] " a, \
104                 (unsigned int)(tv.tv_sec - start_tv.tv_sec), \
105                 (unsigned int)tv.tv_usec, b, c, d); \
106         fflush(logPtr); \
107     }
109 #define LOG4(a, b, c, d, e)  \
110     if (logFile == TRUE) { \
111         struct timeval tv; \
112         gettimeofday(&tv, NULL); \
113         fprintf(logPtr, "[%d.%06d] " a, \
114                 (unsigned int)(tv.tv_sec - start_tv.tv_sec), \
115                 (unsigned int)tv.tv_usec, b, c, d, e); \
116         fflush(logPtr); \
117     }
119 /* macros for generating verbose output: */
120 #define PRINTVERBOSE0(a)  \
121     if (verbose == TRUE) {  printf(a); }
123 #define PRINTVERBOSE1(a, b)  \
124     if (verbose == TRUE) {  printf(a, b); }
126 #define PRINTVERBOSE2(a, b, c)  \
127     if (verbose == TRUE) {  printf(a, b, c); }
129 #define PRINTVERBOSE3(a, b, c, d)  \
130     if (verbose == TRUE) {  printf(a, b, c, d); }
133 /* LAD commmand FIFO strings: */
134 #if defined (IPC_BUILDOS_ANDROID)
135 #define LAD_COMMANDFIFO         "/data/lad/LAD/LADCMDS"
136 #define LAD_ROOTDIR             "/data/lad/"
137 #define LAD_WORKINGDIR          "/data/lad/LAD/"
138 #else
139 #define LAD_COMMANDFIFO         "/tmp/LAD/LADCMDS"
140 #define LAD_ROOTDIR             "/tmp/"
141 #define LAD_WORKINGDIR          "/tmp/LAD/"
142 #endif
144 #define LAD_RESPONSEFIFOPATH    LAD_WORKINGDIR
145 #define LAD_PROTOCOLVERSION     "03000000"    /*  MMSSRRRR */
147 #define LAD_MAXNUMCLIENTS  32      /* max simultaneous clients */
148 #define LAD_CONNECTTIMEOUT 5.0  /* LAD connect response timeout (sec) */
149 #define LAD_DISCONNECTTIMEOUT   5.0  /* LAD disconnect timeout (sec) */
150 #define LAD_MAXLENGTHFIFONAME   128  /* max length client FIFO name */
151 #define LAD_MAXLENGTHCOMMAND    512  /* size limit for LAD command string */
152 #define LAD_MAXLENGTHRESPONSE   512  /* size limit for LAD response string */
153 #define LAD_MAXLENGTHPROTOVERS  16   /* size limit for protocol version */
154 #define LAD_MAXLOGFILEPATH 256  /* size limit for LAD log file path */
155 #define LAD_COMMANDLENGTH       sizeof(struct LAD_CommandObj)
156 #define LAD_RESPONSELENGTH      sizeof(union LAD_ResponseObj)
158 #define LAD_MESSAGEQCREATEMAXNAMELEN 32
160 #define LAD_MAXENTRYNAMELEN  MAXNAMEINCHAR /* max for LAD NameServer name */
161 #define LAD_MAXENTRYVALUELEN 32  /* size limit for LAD NameServer value */
163 typedef enum {
164     LAD_CONNECT = 0,
165     LAD_DISCONNECT,
166     LAD_IPC_GETCONFIG,
167     LAD_NAMESERVER_SETUP,
168     LAD_NAMESERVER_DESTROY,
169     LAD_NAMESERVER_PARAMS_INIT,
170     LAD_NAMESERVER_CREATE,
171     LAD_NAMESERVER_DELETE,
172     LAD_NAMESERVER_ADD,
173     LAD_NAMESERVER_GET,
174     LAD_NAMESERVER_ADDUINT32,
175     LAD_NAMESERVER_GETUINT32,
176     LAD_NAMESERVER_GETLOCAL,
177     LAD_NAMESERVER_GETLOCALUINT32,
178     LAD_NAMESERVER_REMOVE,
179     LAD_NAMESERVER_REMOVEENTRY,
180     LAD_NAMESERVER_ATTACH,
181     LAD_NAMESERVER_DETACH,
182     LAD_MESSAGEQ_GETCONFIG,
183     LAD_MESSAGEQ_SETUP,
184     LAD_MESSAGEQ_DESTROY,
185     LAD_MESSAGEQ_CREATE,
186     LAD_MESSAGEQ_DELETE,
187     LAD_MESSAGEQ_MSGINIT,
188     LAD_MULTIPROC_GETCONFIG,
189     LAD_GATEMP_START,
190     LAD_GATEMP_GETNUMRESOURCES,
191     LAD_GATEMP_GETFREERESOURCE,
192     LAD_GATEMP_RELEASERESOURCE,
193     LAD_GATEMP_ISSETUP,
194     LAD_GATEHWSPINLOCK_GETCONFIG,
195     LAD_EXIT
196 } _LAD_Command;
198 struct LAD_CommandObj {
199     Int cmd;
200     Int clientId;
201     union {
202         struct {
203             Int pid;
204             Char name[LAD_MAXLENGTHFIFONAME];
205             Char protocol[LAD_MAXLENGTHPROTOVERS];
206         } connect;
207         struct {
208             Char name[LAD_MAXENTRYNAMELEN];
209             NameServer_Params params;
210         } create;
211         struct {
212             NameServer_Handle handle;
213         } nsdelete;
214         struct {
215             NameServer_Handle handle;
216             Char name[LAD_MAXENTRYNAMELEN];
217             UInt8 buf[LAD_MAXENTRYVALUELEN];
218             UInt32 len;
219         } add;
220         struct {
221             NameServer_Handle handle;
222             Char name[LAD_MAXENTRYNAMELEN];
223             UInt32 len;
224             UInt16 procId[MultiProc_MAXPROCESSORS];
225         } get;
226         struct {
227             NameServer_Handle handle;
228             Char name[LAD_MAXENTRYNAMELEN];
229             UInt32 val;
230         } addUInt32;
231         struct {
232             NameServer_Handle handle;
233             Char name[LAD_MAXENTRYNAMELEN];
234             UInt16 procId[MultiProc_MAXPROCESSORS];
235         } getUInt32;
236         struct {
237             NameServer_Handle handle;
238             Char name[LAD_MAXENTRYNAMELEN];
239             UInt32 len;
240         } getLocal;
241         struct {
242             NameServer_Handle handle;
243             Char name[LAD_MAXENTRYNAMELEN];
244         } getLocalUInt32;
245         struct {
246             NameServer_Handle handle;
247             Char name[LAD_MAXENTRYNAMELEN];
248         } remove;
249         struct {
250             NameServer_Handle handle;
251             Ptr entryPtr;
252         } removeEntry;
253         struct {
254             UInt16 procId;
255         } attach;
256         struct {
257             UInt16 procId;
258         } detach;
259         struct {
260             MessageQ_Config cfg;
261         } messageQSetup;
262         struct {
263             Char name[LAD_MESSAGEQCREATEMAXNAMELEN];
264             MessageQ_Params params;
265         } messageQCreate;
266         struct {
267             Void *serverHandle;
268         } messageQDelete;
269         struct {
270             GateMP_RemoteProtect type;
271         } gateMPGetNumResources;
272         struct {
273             GateMP_RemoteProtect type;
274         } gateMPGetFreeResource;
275         struct {
276             GateMP_RemoteProtect type;
277             Int32 id;
278         } gateMPReleaseResource;
279         struct {
280             Bool result;
281         } gateMPIsSetup;
282     } args;
283 };
285 union LAD_ResponseObj {
286     struct {
287        Int status;
288        UInt32 len;
289        UInt8 buf[LAD_MAXENTRYVALUELEN];
290     } get;
291     struct {
292        Int status;
293        UInt32 val;
294     } getUInt32;
295     struct {
296        Int status;
297        Int assignedId;
298     } connect;
299     struct {
300        Int status;
301        NameServer_Handle handle;
302     } nsdelete;
303     struct {
304        Int status;
305        NameServer_Handle nameServerHandle;
306     } setup;
307     struct {
308        Int status;
309        Int queueId;
310        Void *serverHandle;
311     } messageQCreate;
312     struct {
313        Int status;
314     } messageQDelete;
315     struct {
316        Int status;
317        MessageQ_MsgHeader msg;
318     } msgInit;
319     struct {
320        Int status;
321        MessageQ_Config cfg;
322     } messageQGetConfig;
323     struct {
324        Int status;
325        MultiProc_Config cfg;
326     } multiprocGetConfig;
327     struct {
328        Int status;
329        NameServer_Handle nameServerHandle;
330     } gateMPStart;
331     struct {
332        Int status;
333        Int32 value;
334     } gateMPGetNumResources;
335     struct {
336        Int status;
337        Int32 id;
338     } gateMPGetFreeResource;
339     struct {
340        Int status;
341     } gateMPReleaseResource;
342     struct {
343        Int status;
344        Bool result;
345     } gateMPIsSetup;
346     struct {
347        Int status;
348        GateHWSpinlock_Config cfgParams;
349     } gateHWSpinlockGetConfig;
350     Ipc_Config ipcConfig;
351     NameServer_Params params;
352     NameServer_Handle handle;
353     Ptr entryPtr;
354     Int status;
355 };
358 #ifdef __cplusplus
360 #endif
362 #endif