C66AK2E: BIOS: Introduce support for C66AK2E
[ipc/ipcdev.git] / packages / ti / sdo / ipc / family / Settings.xs
1 /*
2  * Copyright (c) 2013-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  */
33 /*
34  *  ======== Settings.xs ========
35  */
37 /*
38  *  ======== setDeviceAliases ========
39  */
40 function setDeviceAliases(settingsTable, aliasTable)
41 {
42     /* Number of times to call the outer loop */
43     var numLoops = 6;
45     /*
46      *  Execute the 2nd loop 'numLoops' times to allow aliases of aliases
47      *  to be applied to the table
48      */
49     for (var i = 0; i < numLoops; i++) {
50         for (var device in aliasTable) {
51             for each (var alias in aliasTable[device]) {
52                 /*
53                  *  Define the alias only if the alias doesn't already exist
54                  *  in the table and if the device does exist in the table.
55                  */
56                 if (settingsTable[alias] == null &&
57                     settingsTable[device] != null) {
58                     settingsTable[alias] = settingsTable[device];
59                 }
60             }
61         }
62     }
63 }
65 /*
66  *  ======== setCatalogAliases ========
67  */
68 function setCatalogAliases(settingsTable, aliasTable)
69 {
70     for (var catalogName in settingsTable) {
71         if (aliasTable[catalogName] != null) {
72             var catalogAlias = aliasTable[catalogName];
73             if (settingsTable[catalogAlias] == null) {
74                 settingsTable[catalogAlias] = settingsTable[catalogName];
75                 continue;
76             }
77             for (var deviceName in settingsTable[catalogName]) {
78                 settingsTable[catalogAlias][deviceName] =
79                     settingsTable[catalogName][deviceName];
80             }
81         }
82     }
83 }
85 /*
86  *  ======== deviceSupportCheck ========
87  *  Check validity of device
88  */
89 function deviceSupportCheck()
90 {
91     var deviceName;
93     /* look for exact match */
94     for (deviceName in procNames) {
95         if (deviceName == Program.cpu.deviceName) {
96             return deviceName;
97         }
98     }
100     /* now look for wild card match */
101     for (deviceName in procNames) {
102         if (Program.cpu.deviceName.match(deviceName)) {
103             return deviceName;
104         }
105     }
108 /*
109  *  ======== catalogAliases ========
110  *  Aliases for catalog
111  */
112 var catalogAliases = {
113     'ti.catalog.arm.cortexm3' : ['ti.catalog.arm'],
116 /*
117  *  ======== deviceAliases ========
118  *  Aliases for devices used in IPC
119  */
120 var deviceAliases = {
121     'TMS320C6472'       : ['TMS320CTCI6486'],
122     'TMS320C6474'       : ['TMS320CTCI6488'],
123     'TMS320DA830'       : ['OMAPL138',
124                            'OMAPL137'],
125     'OMAP3530'          : ['TMS320C3430'],
126     'TMS320TI816X'      : ['TMS320CDM740',
127                            'TMS320DM8148',
128                            'TMS320DM8168',
129                            'TMS320C6A8168',
130                            'TMS320C6A8149',
131                            'TMS320TI811X',
132                            'TMS320TI813X',
133                            'TMS320TI814X'],
134     'TMS320C6678'       : ['TMS320TCI6608',
135                            'TMS320C6674',
136                            'TMS320C6672'],
137     'TMS320C6670'       : ['TMS320TCI6616',
138                            'TMS320CTCI6497',
139                            'TMS320CTCI6498',
140                            'TMS320TCI6618',
141                            'TMS320TCI6614',
142                            'TMS320C6657'],
143     'TMS320TCI6634'     : ['TMS320C66AK2E05',
144                            'TMS320TCI6630K2L',
145                            'TMS320TCI6636',
146                            'TMS320TCI6638',
147                            'Kepler'],
148     'LM3.*'             : ['LM4.*'],
149     'Vayu'              : ['DRA7XX']
152 /*
153  *  ======== procNames ========
154  */
155 var procNames = {
156     'TMS320CDM6446'     : ["DSP", "HOST"],
157     'TMS320DA830'       : ["DSP", "HOST"],
158     'OMAPL138'          : ["DSP", "HOST"],
159     'TMS320TI816X'      : ["DSP", "VIDEO-M3", "VPSS-M3", "HOST"],
160     'TMS320TI813X'      : ["VIDEO-M3", "VPSS-M3", "HOST"],
161     'TMS320C6A8168'     : ["DSP", "VPSS-M3", "HOST"],
162     'TMS320C6A8149'     : ["DSP", "EVE", "VIDEO-M3", "VPSS-M3", "HOST"],
163     'TMS320C6670'       : ["CORE0", "CORE1", "CORE2", "CORE3"],
164     'TMS320C6657'       : ["CORE0", "CORE1"],
165     'TMS320C6672'       : ["CORE0", "CORE1"],
166     'TMS320TCI6614'     : ["CORE0", "CORE1", "CORE2", "CORE3", "HOST"],
167     'TMS320TCI6634'     : ["CORE0", "CORE1", "CORE2", "CORE3",
168                            "CORE4", "CORE5", "CORE6", "CORE7"],
170     /*
171      *  Note, the name "HOST" was intentionally chosen as a proc name to
172      *  accomodate TransportRpmsg, a common transport on these platforms.
173      */
174     'TMS320TCI6636'     : ["HOST", "CORE0", "CORE1", "CORE2", "CORE3",
175                            "CORE4", "CORE5", "CORE6", "CORE7"],
176     'TMS320TCI6638'     : ["HOST", "CORE0", "CORE1", "CORE2", "CORE3",
177                            "CORE4", "CORE5", "CORE6", "CORE7"],
178     'Kepler'            : ["HOST", "CORE0", "CORE1", "CORE2", "CORE3",
179                            "CORE4", "CORE5", "CORE6", "CORE7"],
180     'TMS320TCI6630K2L'  : ["HOST", "CORE0", "CORE1", "CORE2", "CORE3"],
181     'TMS320C66AK2E05'     : ["HOST", "CORE0"],
183     'TMS320C6674'       : ["CORE0", "CORE1", "CORE2", "CORE3"],
184     'TMS320C6678'       : ["CORE0", "CORE1", "CORE2", "CORE3",
185                            "CORE4", "CORE5", "CORE6", "CORE7"],
186     'TMS320C6472'       : ["CORE0", "CORE1", "CORE2",
187                            "CORE3", "CORE4", "CORE5"],
188     'TMS320C6474'       : ["CORE0", "CORE1", "CORE2"],
189     'OMAP3530'          : ["DSP", "HOST"],
190     'OMAP4430'          : ["DSP", "CORE0", "CORE1", "HOST"],
192     /*
193      * Note that only SMP-BIOS is supported on OMAP5430, so there's only
194      * one "IPU" proc defined for the dual-core M4.
195      */
196     'OMAP5430'          : ["DSP", "IPU", "HOST"],
198     'Arctic'            : ["DSP", "ARP32"],
199     'F28M3.*'           : ["M3", "C28"],
200     'LM3.*'             : [ "" ],  /* single core, any name can be used */
201     'Vayu'              : ["DSP1", "DSP2", "EVE1", "EVE2", "EVE3", "EVE4",
202                            "IPU1", "IPU2", "IPU1-0", "IPU1-1", "IPU2-0",
203                            "IPU2-1", "HOST"],
204 };
205 setDeviceAliases(procNames, deviceAliases);
207 /*
208  *  ======== hostNeedsSlaveData =======
209  */
210 var hostNeedsSlaveData = {
211     'TMS320TI816X'      : 1,
212     'OMAP3530'          : 1,
213     'OMAP4430'          : 1,
214     'TMS320CDM6446'     : 1,
215     'TMS320DA830'       : 1,
216     'OMAPL138'          : 1,
217     'Vayu'              : 1,
218 };
219 setDeviceAliases(hostNeedsSlaveData, deviceAliases);
221 /*
222  *  ======== sr0MemorySetup =======
223  *  The devices in this list means these devices have a slave mmu
224  *  that needs to be configured by the host before the slave can proceed.
225  */
226 var sr0MemorySetup = {
227     'TMS320TI816X'      : 1,
228     'OMAP3530'          : 1,
229     'OMAP4430'          : 1,
230 };
231 setDeviceAliases(sr0MemorySetup, deviceAliases);
233 /*
234  *  ======== hostProcNames =======
235  *  The name of the host or master processor.
236  */
237 var hostProcNames = {
238     'TMS320CDM6446'     : ["HOST"],
239     'TMS320DA830'       : ["HOST"],
240     'OMAPL138'          : ["HOST"],
241     'TMS320TI816X'      : ["HOST"],
242     'OMAP3530'          : ["HOST"],
243     'OMAP4430'          : ["HOST"],
244     'TMS320C6678'       : ["CORE0"],
245     'TMS320C6670'       : ["CORE0"],
246     'TMS320C6472'       : ["CORE0"],
247     'TMS320C6474'       : ["CORE0"],
248     'F28M3.*'           : ["M3"],
249     'TMS320TCI6630K2L'  : ["HOST"],
250     'TMS320TCI6634'     : ["CORE0"],
251     'TMS320TCI6636'     : ["HOST0"],
252     'TMS320TCI6638'     : ["HOST0"],
253     'Kepler'            : ["HOST"],
254 };
255 setDeviceAliases(hostProcNames, deviceAliases);
257 /*
258  *  ======== nameServerRemoteDelegates ========
259  */
260 var nameServerRemoteDelegates = {
261     'OMAP3530'          : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
262     'TMS320CDM6446'     : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
263     'TMS320DA830'       : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
264     'TMS320TI816X'      : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
265     'TMS320C6678'       : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
266     'TMS320C6670'       : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
267     'TMS320C6472'       : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
268     'TMS320C6474'       : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
269     'OMAP4430'          : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
270     'Arctic'            : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
271     'F28M3.*'           : { del: 'ti.sdo.ipc.family.f28m35x.NameServerBlock', },
272     'Vayu'              : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
273     'TMS320TCI6634'     : { del: 'ti.sdo.ipc.nsremote.NameServerRemoteNotify',},
274 };
275 setDeviceAliases(nameServerRemoteDelegates, deviceAliases);
277 /*
278  *  ======== notifySetupDelegates ========
279  */
280 var notifySetupDelegates = {
281     'OMAP3530'          : { del: 'ti.sdo.ipc.family.omap3530.NotifySetup', },
282     'TMS320CDM6446'     : { del: 'ti.sdo.ipc.family.dm6446.NotifySetup', },
283     'TMS320DA830'       : { del: 'ti.sdo.ipc.family.da830.NotifySetup', },
284     'TMS320TI816X'      : { del: 'ti.sdo.ipc.family.ti81xx.NotifySetup', },
285     'TMS320C6A8149'     : { del: 'ti.sdo.ipc.family.c6a8149.NotifySetup', },
286     'TMS320C6678'       : { del: 'ti.sdo.ipc.family.c647x.NotifySetup', },
287     'TMS320C6670'       : { del: 'ti.sdo.ipc.family.c647x.NotifySetup', },
288     'TMS320C6472'       : { del: 'ti.sdo.ipc.family.c647x.NotifySetup', },
289     'TMS320C6474'       : { del: 'ti.sdo.ipc.family.c647x.NotifySetup', },
290     'TMS320TCI6634'     : { del: 'ti.sdo.ipc.family.tci663x.NotifyCircSetup', },
291     'OMAP4430'          : { del: 'ti.sdo.ipc.family.omap4430.NotifySetup', },
292     'Arctic'            : { del: 'ti.sdo.ipc.family.arctic.NotifyCircSetup', },
293     'F28M3.*'           : { del: 'ti.sdo.ipc.notifyDrivers.NotifySetupNull', },
294     'LM3.*'             : { del: 'ti.sdo.ipc.notifyDrivers.NotifySetupNull', },
295     'Vayu'              : { del: 'ti.sdo.ipc.family.vayu.NotifySetup', },
296     'OMAP5430'          : { del: 'ti.sdo.ipc.notifyDrivers.NotifySetupNull' }
298 };
299 setDeviceAliases(notifySetupDelegates, deviceAliases);
301 /*
302  *  ======== messageQSetupDelegates ========
303  */
304 var messageQSetupDelegates = {
305     'OMAP3530'          : { del: 'ti.sdo.ipc.transports.TransportShmSetup', },
306     'TMS320CDM6446'     : { del: 'ti.sdo.ipc.transports.TransportShmSetup', },
307     'TMS320DA830'       : { del: 'ti.sdo.ipc.transports.TransportShmSetup', },
308     'TMS320TI816X'      : { del: 'ti.sdo.ipc.transports.TransportShmSetup', },
309     'TMS320C6A8149'     : { del: 'ti.sdo.ipc.transports.TransportShmSetup', },
310     'TMS320C6678'       : { del: 'ti.sdo.ipc.transports.TransportShmSetup', },
311     'TMS320C6670'       : { del: 'ti.sdo.ipc.transports.TransportShmSetup', },
312     'TMS320C6472'       : { del: 'ti.sdo.ipc.transports.TransportShmSetup', },
313     'TMS320C6474'       : { del: 'ti.sdo.ipc.transports.TransportShmSetup', },
314     'TMS320TCI6634'     : { del: 'ti.sdo.ipc.transports.TransportShmNotifySetup', },
315     'OMAP4430'          : { del: 'ti.sdo.ipc.transports.TransportShmSetup', },
316     'Arctic'            : { del: 'ti.sdo.ipc.transports.TransportShmNotifySetup', },
317     'F28M3.*'           : { del: 'ti.sdo.ipc.transports.TransportNullSetup', },
318     'LM3.*'             : { del: 'ti.sdo.ipc.transports.TransportNullSetup', },
319     'Vayu'              : { del: 'ti.sdo.ipc.transports.TransportShmSetup', },
320 };
321 setDeviceAliases(messageQSetupDelegates, deviceAliases);
323 /*
324  *  ======== interruptDelegates ========
325  */
326 var interruptDelegates = {
327     'ti.catalog.arm' : {
328         'TMS320CDM6446' : { del: 'ti.sdo.ipc.family.dm6446.InterruptArm', },
329         'TMS320DA830'   : { del: 'ti.sdo.ipc.family.da830.InterruptArm', },
330         'OMAPL138'      : { del: 'ti.sdo.ipc.family.da830.InterruptArm', },
331     },
332     'ti.catalog.arm.cortexm3' : {
333         'TMS320TI816X'  : { del: 'ti.sdo.ipc.family.ti81xx.InterruptDucati', },
334         'TMS320C6A8149' : { del: 'ti.sdo.ipc.family.c6a8149.InterruptDucati', },
335         'OMAP4430'      : { del: 'ti.sdo.ipc.family.omap4430.InterruptDucati', },
336         'F28M3.*'       : { del: 'ti.sdo.ipc.family.f28m35x.InterruptM3', },
337     },
338     'ti.catalog.arm.cortexm4' : {
339         'Vayu'          : { del: 'ti.sdo.ipc.family.vayu.InterruptIpu', },
340     },
341     'ti.catalog.arm.cortexa8' : {
342         'TMS320TI816X'  : { del: 'ti.sdo.ipc.family.ti81xx.InterruptHost', },
343         'TMS320C6A8149' : { del: 'ti.sdo.ipc.family.c6a8149.InterruptHost', },
344         'OMAP3530'      : { del: 'ti.sdo.ipc.family.omap3530.InterruptHost', },
345     },
346     'ti.catalog.arm.cortexa15' : {
347         'Vayu'          : { del: 'ti.sdo.ipc.family.vayu.InterruptHost', },
348     },
349     'ti.catalog.c6000' : {
350         'OMAP3530'      : { del: 'ti.sdo.ipc.family.omap3530.InterruptDsp', },
351         'TMS320CDM6446' : { del: 'ti.sdo.ipc.family.dm6446.InterruptDsp', },
352         'TMS320DA830'   : { del: 'ti.sdo.ipc.family.da830.InterruptDsp', },
353         'OMAPL138'      : { del: 'ti.sdo.ipc.family.da830.InterruptDsp', },
354         'TMS320TI816X'  : { del: 'ti.sdo.ipc.family.ti81xx.InterruptDsp', },
355         'TMS320C6A8149' : { del: 'ti.sdo.ipc.family.c6a8149.InterruptDsp', },
356         'TMS320C6472'   : { del: 'ti.sdo.ipc.family.c647x.Interrupt', },
357         'TMS320C6474'   : { del: 'ti.sdo.ipc.family.c647x.Interrupt', },
358         'TMS320C6678'   : { del: 'ti.sdo.ipc.family.c647x.Interrupt', },
359         'TMS320C6670'   : { del: 'ti.sdo.ipc.family.c647x.Interrupt', },
360         'TMS320TCI6634' : { del: 'ti.sdo.ipc.family.tci663x.Interrupt', },
362         'OMAP4430'      : { del: 'ti.sdo.ipc.family.omap4430.InterruptDsp', },
363         'Arctic'        : { del: 'ti.sdo.ipc.family.arctic.InterruptDsp', },
364         'Vayu'          : { del: 'ti.sdo.ipc.family.vayu.InterruptDsp', },
365     },
366     'ti.catalog.arp32' : {
367         'TMS320C6A8149' : { del: 'ti.sdo.ipc.family.c6a8149.InterruptEve', },
368         'Arctic'        : { del: 'ti.sdo.ipc.family.arctic.InterruptArp32', },
369         'Vayu'          : { del: 'ti.sdo.ipc.family.vayu.InterruptArp32', },
370     },
371     'ti.catalog.c2800' : {
372         'F28M3.*'       : { del: 'ti.sdo.ipc.family.f28m35x.InterruptC28', },
373     },
374 };
375 for (var family in interruptDelegates) {
376     setDeviceAliases(interruptDelegates[family], deviceAliases);
378 setCatalogAliases(interruptDelegates, catalogAliases);
380 /*
381  *  ======== spinlockDelegates ========
382  */
383 var spinlockDelegates = {
384     'ti.catalog.arm.cortexm3' : {
385         'OMAP4430' : {
386             baseAddr:   0x4A0F6800,
387             numLocks:   32,
388         },
389         'TMS320TI816X' : {
390             baseAddr:   0x480CA800,
391             numLocks:   64,
392         },
393     },
394     'ti.catalog.arm.cortexm4' : {
395         'Vayu' : {
396             baseAddr:   0x4A0F6800,
397             numLocks:   32
398         },
399     },
400     'ti.catalog.arm.cortexa8' : {
401         'TMS320TI816X' : {
402             baseAddr:   0x480CA800,
403             numLocks:   64,
404         },
405     },
406     'ti.catalog.arm.cortexa15' : {
407         'Vayu' : {
408             baseAddr:   0x4A0F6800,
409             numLocks:   32
410         },
411     },
412     'ti.catalog.c6000' : {
413         'TMS320TI816X' : {
414             baseAddr:   0x080CA800,
415             numLocks:   64,
416         },
417         'OMAP4430' : {
418             baseAddr:   0x4A0F6800,
419             numLocks:   32,
420         },
421         'Arctic' : {
422             baseAddr:   0x480CA800,
423             numLocks:   64,
424         },
425         'Vayu' : {
426             baseAddr:   0x4A0F6800,
427             numLocks:   32
428         },
429     },
430     'ti.catalog.arp32' : {
431         /*      'TMS320C6A8149' : {
432                     baseAddr:   0x480CA800,
433                     numLocks:   64,
434                 },
435         */
436         'Arctic' : {
437             baseAddr:   0x480CA800,
438             numLocks:   64,
439         },
440         'Vayu' : {
441             baseAddr:   0x4A0F6800,
442             numLocks:   32
443         },
444     }
446 for (var family in spinlockDelegates) {
447     setDeviceAliases(spinlockDelegates[family], deviceAliases);
449 setCatalogAliases(spinlockDelegates, catalogAliases);
451 /*
452  *  ======== hwSemDelegates ========
453  */
454 var hwSemDelegates = {
455     'ti.catalog.c6000' : {
456         'TMS320C6474' : {
457             baseAddr:   0x02B40100,
458             queryAddr:  0x02B40300,
459             numSems:    32,
460         },
461         'TMS320C6678' : {
462             baseAddr:   0x02640100,
463             queryAddr:  0x02640200,
464             numSems:    32,
465         },
466         'TMS320C6670' : {
467             baseAddr:   0x02640100,
468             queryAddr:  0x02640200,
469             numSems:    32,
470         },
471         'TMS320TCI6634' : {
472             baseAddr:   0x02640100,
473             queryAddr:  0x02640200,
474             numSems:    32,
475         },
476     },
478 for (var family in hwSemDelegates) {
479     setDeviceAliases(hwSemDelegates[family], deviceAliases);
481 setCatalogAliases(hwSemDelegates, catalogAliases);
483 /*
484  *  ======== getGateHWSemSettings ========
485  */
486 function getGateHWSemSettings()
488     var errorString = "IPC does not have a default GateHWSem" +
489                       " delegate for the " + deviceName + " device!";
490     var catalogName = Program.cpu.catalogName;
491     var deviceName = deviceSupportCheck();
493     var errStr = "The device " + deviceName +
494         " does not support hardware semaphores!";
496     try {
497         var hwSemSettings = hwSemDelegates[catalogName][deviceName];
498     }
499     catch(e) {
500         throw new Error(errStr);
501     }
503     if (hwSemSettings == null) {
504         throw new Error(errStr);
505     }
507     return (hwSemSettings);
510 /*
511  *  ======== getGateHWSpinlockSettings ========
512  */
513 function getGateHWSpinlockSettings()
515     var errorString = "IPC does not have a default GateHWSpinlock" +
516                       " delegate for the " + deviceName + " device!";
517     var catalogName = Program.cpu.catalogName;
518     var deviceName = deviceSupportCheck();
520     var errStr = "The device " + deviceName +
521         " does not support hardware spinlocks!";
523     try {
524         var spinLockSettings = spinlockDelegates[catalogName][deviceName];
525     }
526     catch(e) {
527         throw new Error(errStr);
528     }
530     if (spinLockSettings == null) {
531         throw new Error(errStr);
532     }
534     return (spinLockSettings);
537 /*
538  *  ======== generateSlaveDataForHost ========
539  */
540 function generateSlaveDataForHost()
542     var deviceName = deviceSupportCheck();
543     var retval = hostNeedsSlaveData[deviceName];
545     /* A15 is the already the host no need to generate data */
546     if ((Program.cpu.catalogName == 'ti.catalog.arm.cortexa8') ||
547         (Program.cpu.catalogName == 'ti.catalog.arm.cortexa9') ||
548         (Program.cpu.catalogName == 'ti.catalog.arm.cortexa15')) {
549         return (false);
550     }
552     if (retval != null) {
553         return (true);
554     }
556     return (false);
559 /*
560  *  ======== getHostProcId ========
561  */
562 function getHostProcId()
564     var MultiProc = xdc.module("ti.sdo.utils.MultiProc");
565     var deviceName = deviceSupportCheck();
566     var hostProcName = hostProcNames[deviceName];
568     if (hostProcName == null) {
569         /* The device doesn't have a core that runs a hlos */
570         return (MultiProc.INVALIDID);
571     }
573     /*
574      *  If the device may run a hlos, return the corresponding core's MultiProc
575      *  id. MultiProc.INVALIDID will be returned if the core exists but isn't
576      *  being used in the application
577      */
578     return(MultiProc.getIdMeta(String(hostProcName)));
581 /*
582  *  ======== getIpcSR0Setup ========
583  */
584 function getIpcSR0Setup()
586     var deviceName = deviceSupportCheck();
587     var memorySetup = sr0MemorySetup[deviceName];
589     if (memorySetup == null) {
590         /* The device has memory available to it */
591         return (true);
592     }
593     else {
594         /* The device needs host to enable memory through mmu */
595         return (false);
596     }
599 /*
600  *  ======== getHWGate ========
601  */
602 function getHWGate()
604     var deviceName = deviceSupportCheck();
605     if (deviceName == "TMS320C6472" ||
606         deviceName == "TMS320CTCI6486") {
607         return ('ti.sdo.ipc.gates.GateAAMonitor');
608     }
609     else if (deviceName == "TMS320C6A8149") {
610         return ('ti.sdo.ipc.gates.GatePetersonN');
611     }
612     try {
613         this.getGateHWSpinlockSettings();
614         return ('ti.sdo.ipc.gates.GateHWSpinlock');
615     }
616     catch(e) {
617     }
619     try {
620         this.getGateHWSemSettings();
621         return ('ti.sdo.ipc.gates.GateHWSem');
622     }
623     catch(e) {
624     }
626     return('ti.sdo.ipc.gates.GatePeterson');
629 /*
630  *  ======== getDefaultInterruptDelegate ========
631  */
632 function getDefaultInterruptDelegate()
634     var catalogName = Program.cpu.catalogName;
635     var deviceName = deviceSupportCheck();
637     var delegate = interruptDelegates[catalogName][deviceName];
639     if (delegate == null) {
640         throw new Error ("IPC does not have a default Interrupt"
641             + " delegate for the " + deviceName + " device!");
642     }
644     return (delegate.del);
647 /*
648  *  ======== getNameServerRemoteDelegate ========
649  */
650 function getNameServerRemoteDelegate()
652     var deviceName = deviceSupportCheck();
654     var delegate = nameServerRemoteDelegates[deviceName];
656     if (delegate == null) {
657         delegate = { del: 'ti.sdo.utils.NameServerRemoteNull', };
658     }
660     return (delegate.del);
663 /*
664  *  ======== getNotifySetupDelegate ========
665  */
666 function getNotifySetupDelegate()
668     var deviceName = deviceSupportCheck();
670     var delegate = notifySetupDelegates[deviceName];
672     if (delegate == null) {
673         throw new Error ("IPC does not have a default NotifySetup"
674             + " delegate for the " + deviceName + " device!");
675     }
677     return (delegate.del);
680 /*
681  *  ======== getMessageQSetupDelegate ========
682  */
683 function getMessageQSetupDelegate()
685     var deviceName = deviceSupportCheck();
687     var delegate = messageQSetupDelegates[deviceName];
689     if (delegate == null) {
690         throw new Error ("IPC does not have a default MessageQ setup"
691             + " delegate for the " + deviceName + " device!");
692     }
694     return (delegate.del);
697 /*
698  *  ======== procInDevice ========
699  */
700 function procInDevice(procName)
702     var deviceName = deviceSupportCheck();
703     if (procNames[deviceName] == null) {
704         throw("The device (" + Program.cpu.deviceName +
705                        ") isn't supported by IPC");
706     }
708     /* Search through the procNames table */
709     for each (name in procNames[deviceName]) {
710         if (name == procName) {
711             return (true);
712         }
713     }
715     return (false);
718 /*
719  *  ======== getDeviceProcNames ========
720  */
721 function getDeviceProcNames()
723     var deviceName = deviceSupportCheck();
724     if (procNames[deviceName] == null) {
725         throw("The device (" + Program.cpu.deviceName +
726                        ") isn't supported by IPC");
727     }
729     return (procNames[deviceName]);