cbdc80e504a042d844d918dbed72f2fe08830a48
[ipc/ipcdev.git] / linux / src / api / SysLink.c
1 /*
2  * Copyright (c) 2012, Texas Instruments Incorporated
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  *  @file       SysLink.c
34  *
35  *  @brief      Initializes and finalizes user side SysLink
36  *              All setup/destroy APIs on user side will be call from this
37  *              module.
38  *
39  *  @ver        0002
40  *
41  */
43 /* Standard headers */
44 #include <stdio.h>
45 #include <stdlib.h>
46 #include <signal.h>
47 #include <Std.h>
49 /* Common IPC headers: */
50 #include <ti/ipc/NameServer.h>
52 /* User side headers */
53 #include <ladclient.h>
54 #include <SysLink.h>
56 /* IPC startup/shutdown stuff: */
57 #include <ti/ipc/MultiProc.h>
58 #include <_MessageQ.h>
59 #include <_NameServer.h>
61 static LAD_ClientHandle ladHandle;
63 static void cleanup(int arg);
65 /** ============================================================================
66  *  Functions
67  *  ============================================================================
68  */
69 /* Function to initialize SysLink. */
70 Int SysLink_setup (Void)
71 {
72     MessageQ_Config   msgqCfg;
73     Int32             status = 0;
74     LAD_Status        ladStatus;
75     UInt16            rprocId;
77     /* Catch ctrl-C, and cleanup: */
78     (void) signal(SIGINT, cleanup);
80     ladStatus = LAD_connect(&ladHandle);
81     if (ladStatus != LAD_SUCCESS) {
82         printf("SysLink_setup: LAD_connect() failed: %d\n", ladStatus);
83         status = SysLink_E_RESOURCE;
84         goto exit;
85     }
87     status = NameServer_setup();
88     if (status >= 0) {
89         MessageQ_getConfig(&msgqCfg);
90         MessageQ_setup(&msgqCfg);
92         /* Now attach to all remote processors, assuming they are up. */
93         for (rprocId = 0;
94              (rprocId < MultiProc_getNumProcessors()) && (status >= 0);
95              rprocId++) {
96            if (0 == rprocId) {
97                /* Skip host, which should always be 0th entry. */
98                continue;
99            }
100            status = MessageQ_attach (rprocId, NULL);
101            if (status < 0) {
102               printf("SysLink_setup: MessageQ_attach(%d) failed: %d\n",
103                      rprocId, status);
104            }
105         }
106     }
108 exit:
109     return (status);
113 /* Function to finalize SysLink. */
114 Void SysLink_destroy (Void)
116     Int32             status = 0;
117     LAD_Status        ladStatus;
118     UInt16            rprocId;
120     /* Now detach from all remote processors, assuming they are up. */
121     for (rprocId = 0;
122          (rprocId < MultiProc_getNumProcessors()) && (status >= 0);
123          rprocId++) {
124        if (0 == rprocId) {
125           /* Skip host, which should always be 0th entry. */
126           continue;
127        }
128        status = MessageQ_detach(rprocId);
129        if (status < 0) {
130           printf("SysLink_destroy: MessageQ_detach(%d) failed: %d\n",
131                  rprocId, status);
132        }
133     }
135     status = MessageQ_destroy();
136     if (status < 0) {
137        printf("SysLink_destroy: MessageQ_destroy() failed: %d\n", status);
138     }
140     status = NameServer_destroy();
141     if (status < 0) {
142        printf("SysLink_destroy: NameServer_destroy() failed: %d\n", status);
143     }
145     ladStatus = LAD_disconnect(ladHandle);
146     if (ladStatus != LAD_SUCCESS) {
147         printf("LAD_disconnect() failed: %d\n", ladStatus);
148     }
151 static void cleanup(int arg)
153     printf("SysLink: Caught SIGINT, calling SysLink_destroy...\n");
154     SysLink_destroy();
155     exit(0);