linux/src/api/Ipc.c

   1 /*
   2  * Copyright (c) 2012-2013, 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       Ipc.c
  34  *
  35  *  @brief      Starts and stops user side Ipc
  36  *              All setup/destroy APIs on user side will be call from this
  37  *              module.
  38  *
  39  *  @ver        0002
  40  *
  41  */
  42
  43 /* Standard headers */
  44 #include <stdio.h>
  45 #include <stdlib.h>
  46 #include <signal.h>
  47
  48 /* Common IPC headers: */
  49 #include <ti/ipc/Std.h>
  50 #include <ti/ipc/Ipc.h>
  51 #include <ti/ipc/NameServer.h>
  52
  53 /* User side headers */
  54 #include <ladclient.h>
  55
  56 /* IPC startup/shutdown stuff: */
  57 #include <ti/ipc/MultiProc.h>
  58 #include <_MessageQ.h>
  59 #include <_NameServer.h>
  60
  61 MultiProc_Config _MultiProc_cfg;
  62
  63 static LAD_ClientHandle ladHandle;
  64
  65 static void cleanup(int arg);
  66
  67 /** ============================================================================
  68  *  Functions
  69  *  ============================================================================
  70  */
  71 /* Function to start Ipc */
  72 Int Ipc_start (Void)
  73 {
  74     MessageQ_Config   msgqCfg;
  75     MultiProc_Config  mpCfg;
  76     Int32             status;
  77     LAD_Status        ladStatus;
  78     UInt16            rprocId;
  79     Int32             attachedAny = 0;
  80
  81     /* Catch ctrl-C, and cleanup: */
  82     (void) signal(SIGINT, cleanup);
  83
  84     ladStatus = LAD_connect(&ladHandle);
  85     if (ladStatus != LAD_SUCCESS) {
  86         printf("Ipc_start: LAD_connect() failed: %d\n", ladStatus);
  87         status = Ipc_E_FAIL;
  88         goto exit;
  89     }
  90
  91     /* Setup and get MultiProc configuration from LAD */
  92     MultiProc_getConfig(&mpCfg);
  93     _MultiProc_cfg = mpCfg;
  94
  95     status = NameServer_setup();
  96     if (status >= 0) {
  97         MessageQ_getConfig(&msgqCfg);
  98         MessageQ_setup(&msgqCfg);
  99
 100         /* Now attach to all remote processors, assuming they are up. */
 101         for (rprocId = 0; rprocId < MultiProc_getNumProcessors(); rprocId++) {
 102             if (0 == rprocId) {
 103                 /* Skip host, which should always be 0th entry. */
 104                 continue;
 105             }
 106             status = MessageQ_attach(rprocId, NULL);
 107             if (status == MessageQ_E_RESOURCE) {
 108                 continue;
 109             }
 110             if (status < 0) {
 111                 printf("Ipc_start: MessageQ_attach(%d) failed: %d\n",
 112                        rprocId, status);
 113                 status = Ipc_E_FAIL;
 114
 115                 break;
 116             }
 117             else {
 118                 attachedAny = 1;
 119             }
 120         }
 121         if (attachedAny) {
 122             status = Ipc_S_SUCCESS;
 123         }
 124     }
 125     else {
 126         printf("Ipc_start: NameServer_setup() failed: %d\n", status);
 127         status = Ipc_E_FAIL;
 128     }
 129
 130 exit:
 131     return (status);
 132 }
 133
 134
 135 /* Function to stop Ipc */
 136 Int Ipc_stop (Void)
 137 {
 138     Int32             status = Ipc_S_SUCCESS;
 139     LAD_Status        ladStatus;
 140     UInt16            rprocId;
 141
 142     /* Now detach from all remote processors, assuming they are up. */
 143     for (rprocId = 0;
 144          (rprocId < MultiProc_getNumProcessors()) && (status >= 0);
 145          rprocId++) {
 146         if (0 == rprocId) {
 147           /* Skip host, which should always be 0th entry. */
 148           continue;
 149         }
 150         status = MessageQ_detach(rprocId);
 151         if (status < 0) {
 152             printf("Ipc_stop: MessageQ_detach(%d) failed: %d\n",
 153                 rprocId, status);
 154             status = Ipc_E_FAIL;
 155             goto exit;
 156        }
 157     }
 158
 159     status = MessageQ_destroy();
 160     if (status < 0) {
 161         printf("Ipc_stop: MessageQ_destroy() failed: %d\n", status);
 162         status = Ipc_E_FAIL;
 163         goto exit;
 164     }
 165
 166     status = NameServer_destroy();
 167     if (status < 0) {
 168         printf("Ipc_stop: NameServer_destroy() failed: %d\n", status);
 169         status = Ipc_E_FAIL;
 170         goto exit;
 171     }
 172
 173     ladStatus = LAD_disconnect(ladHandle);
 174     if (ladStatus != LAD_SUCCESS) {
 175         printf("LAD_disconnect() failed: %d\n", ladStatus);
 176         status = Ipc_E_FAIL;
 177         goto exit;
 178     }
 179
 180 exit:
 181     return (status);
 182 }
 183
 184 static void cleanup(int arg)
 185 {
 186     printf("Ipc: Caught SIGINT, calling Ipc_stop...\n");
 187     Ipc_stop();
 188     exit(0);
 189 }