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