1 /* 2 * Copyright (c) 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 * ======== Core.xdc ======== 34 * 35 */ 36 37 /*! 38 * ======== Core ======== 39 * "Global Proxy" for target specific Core implementations 40 */ 41 module Core inherits ti.sysbios.interfaces.ICore 42 { 43 44 @Macro 45 override UInt hwiDisable(); 46 47 @Macro 48 override UInt hwiEnable(); 49 50 @Macro 51 override Void hwiRestore(UInt key); 52 53 /*! 54 * ======== getId ======== 55 * return the current core id 56 */ 57 @Macro 58 override UInt getId(); 59 60 /*! 61 * ======== interruptCore ======== 62 * Cause an interrupt on a particular core. 63 */ 64 @Macro 65 override Void interruptCore(UInt coreId); 66 67 /*! 68 * ======== lock ======== 69 * acquire Inter-core lock. 70 * 71 * @a(constraints) 72 * This function should always be called with interrupts disabled. 73 */ 74 @Macro 75 override Void lock(); 76 77 /*! 78 * ======== unlock ======== 79 * release Inter-core lock. 80 */ 81 @Macro 82 override Void unlock(); 83 84 internal: /* not for client use */ 85 86 /*! target/device-specific ICore implementation. */ 87 proxy CoreProxy inherits ti.sysbios.interfaces.ICore; 88 }