1 /* 2 * Copyright (c) 2015-2020, 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 * ======== Core.xdc ======== 34 */ 35 36 /*! 37 * ======== Core ======== 38 * "Global Proxy" for target specific Core implementations 39 */ 40 module Core inherits ti.sysbios.interfaces.ICore 41 { 42 /*! 43 * ======== numCores ======== 44 * @a(NOTE) 45 * This configuration parameter should be set in a family specific or 46 * delegate Core module. Setting "ti.sysbios.hal.Core" module's "numCores" 47 * field does not have the desired affect in SMP mode. This is because all 48 * SMP aware modules reference the family specific (or delegate) Core 49 * module's "numCores" field to determine the number of CPU cores. 50 */ 51 /* REQ_TAG(SYSBIOS-1257) */ 52 override config UInt numCores; 53 54 /* REQ_TAG(SYSBIOS-1260) */ 55 @Macro 56 override UInt hwiDisable(); 57 58 /* REQ_TAG(SYSBIOS-1261) */ 59 @Macro 60 override UInt hwiEnable(); 61 62 /* REQ_TAG(SYSBIOS-1262) */ 63 @Macro 64 override Void hwiRestore(UInt key); 65 66 /*! 67 * ======== getId ======== 68 * return the current core id 69 */ 70 /* REQ_TAG(SYSBIOS-1258) */ 71 @Macro 72 override UInt getId(); 73 74 /*! 75 * @_nodoc 76 * ======== interruptCore ======== 77 * Cause an interrupt on a particular core. 78 */ 79 /* REQ_TAG(SYSBIOS-1259) */ 80 @Macro 81 override Void interruptCore(UInt coreId); 82 83 /*! 84 * ======== lock ======== 85 * acquire Inter-core lock. 86 */ 87 @Macro 88 override IArg lock(); 89 90 /*! 91 * ======== unlock ======== 92 * release Inter-core lock. 93 */ 94 @Macro 95 override Void unlock(); 96 97 internal: /* not for client use */ 98 99 /*! target/device-specific ICore implementation. */ 100 /* REQ_TAG(SYSBIOS-1263) */ 101 proxy CoreProxy inherits ti.sysbios.interfaces.ICore; 102 }