packages/ti/ipc/ipcmgr/IpcMgr.c

   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 /*
  34  *  ======== IpcMgr.c ========
  35  *  Various IPC stack backplane startup fxns.
  36  */
  37
  38 #include <xdc/std.h>
  39 #include <xdc/runtime/Assert.h>
  40
  41 #include <ti/ipc/Ipc.h>
  42 #include <ti/ipc/MultiProc.h>
  43 #include <ti/ipc/namesrv/NameServerRemoteRpmsg.h>
  44 #include <ti/ipc/transports/TransportRpmsgSetup.h>
  45 #include <ti/ipc/rpmsg/_RPMessage.h>
  46
  47 #ifdef IpcMgr_USEDEH
  48 #include <ti/deh/Watchdog.h>
  49 #ifdef IpcMgr_DSP
  50 #include <ti/sysbios/family/c64p/Exception.h>
  51 #elif IpcMgr_IPU
  52 #include <ti/sysbios/family/arm/m3/Hwi.h>
  53 #endif
  54 #endif
  55
  56 #include "IpcMgr.h"
  57
  58
  59 /*
  60  *  ======== IpcMgr_rpmsgStartup ========
  61  *  Initialize the RPMSG module. This calls VirtQueue_startup().
  62  *
  63  *  Use for stacks built on RPMessage only.
  64  */
  65 Void IpcMgr_rpmsgStartup(Void)
  66 {
  67     Assert_isTrue(MultiProc_self() != MultiProc_getId("HOST"), 0);
  68     RPMessage_init(MultiProc_getId("HOST"));
  69
  70 #ifdef IpcMgr_USEDEH
  71     /*
  72      * When using DEH, initialize the Watchdog timers if not already done
  73      * (i.e. late-attach)
  74      */
  75 #ifdef IpcMgr_DSP
  76     Watchdog_init((Void (*)(Void))ti_sysbios_family_c64p_Exception_handler);
  77 #elif IpcMgr_IPU
  78     Watchdog_init(ti_sysbios_family_arm_m3_Hwi_excHandlerAsm__I);
  79 #endif
  80 #endif
  81 }
  82
  83 /*
  84  *  ======== IpcMgr_ipcStartup ========
  85  *  Initialize MessageQ Transport stack built over RPMSG.
  86  *  This ends up calling RPMessage_init().
  87  *
  88  *  Use for stacks built on MessageQ/TransportRpmsg only.
  89  */
  90 Void IpcMgr_ipcStartup(Void)
  91 {
  92     UInt procId = MultiProc_getId("HOST");
  93     Int status;
  94
  95     /* TransportRpmsgSetup will busy wait until host kicks ready to recv: */
  96     status = TransportRpmsgSetup_attach(procId, 0);
  97     Assert_isTrue(status >= 0, NULL);
  98
  99     /* Sets up to communicate with host's NameServer: */
 100     status = NameServerRemoteRpmsg_attach(procId, 0);
 101     Assert_isTrue(status >= 0, NULL);
 102
 103 #ifdef IpcMgr_USEDEH
 104     /*
 105      * When using DEH, initialize the Watchdog timers if not already done
 106      * (i.e. late-attach)
 107      */
 108 #ifdef IpcMgr_DSP
 109     Watchdog_init((Void (*)(Void))ti_sysbios_family_c64p_Exception_handler);
 110 #elif IpcMgr_IPU
 111     Watchdog_init(ti_sysbios_family_arm_m3_Hwi_excHandlerAsm__I);
 112 #endif
 113 #endif
 114 }
 115
 116 /*
 117  *  ======== IpcMgr_callIpcStart ========
 118  *  Initialize standard IPC module, which may use the RPMSG protocol as well.
 119  *
 120  *  Calls the Ipc_start command.  This must be done after IpcMgr_ipcStartup().
 121  *
 122  *  Use for stacks using a combination of TransportRpmsg and other Transports.
 123  */
 124 Void IpcMgr_callIpcStart()
 125 {
 126     Int status;
 127
 128     /*
 129      *  Ipc_start() calls Ipc_attach() to synchronize all remote processors
 130      *  if 'Ipc.procSync' is set to 'Ipc.ProcSync_ALL' in *.cfg
 131      *  HOST is skipped, thanks to overriding NotifySetup_numIntLines().
 132      */
 133     status = Ipc_start();
 134     Assert_isTrue(status >= 0, NULL);
 135 }