1*4882a593Smuzhiyun /* 2*4882a593Smuzhiyun * tie.h -- compile-time HAL definitions dependent on CORE & TIE configuration 3*4882a593Smuzhiyun * 4*4882a593Smuzhiyun * NOTE: This header file is not meant to be included directly. 5*4882a593Smuzhiyun */ 6*4882a593Smuzhiyun 7*4882a593Smuzhiyun /* This header file describes this specific Xtensa processor's TIE extensions 8*4882a593Smuzhiyun that extend basic Xtensa core functionality. It is customized to this 9*4882a593Smuzhiyun Xtensa processor configuration. 10*4882a593Smuzhiyun 11*4882a593Smuzhiyun Copyright (c) 1999-2010 Tensilica Inc. 12*4882a593Smuzhiyun 13*4882a593Smuzhiyun Permission is hereby granted, free of charge, to any person obtaining 14*4882a593Smuzhiyun a copy of this software and associated documentation files (the 15*4882a593Smuzhiyun "Software"), to deal in the Software without restriction, including 16*4882a593Smuzhiyun without limitation the rights to use, copy, modify, merge, publish, 17*4882a593Smuzhiyun distribute, sublicense, and/or sell copies of the Software, and to 18*4882a593Smuzhiyun permit persons to whom the Software is furnished to do so, subject to 19*4882a593Smuzhiyun the following conditions: 20*4882a593Smuzhiyun 21*4882a593Smuzhiyun The above copyright notice and this permission notice shall be included 22*4882a593Smuzhiyun in all copies or substantial portions of the Software. 23*4882a593Smuzhiyun 24*4882a593Smuzhiyun THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 25*4882a593Smuzhiyun EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 26*4882a593Smuzhiyun MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 27*4882a593Smuzhiyun IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY 28*4882a593Smuzhiyun CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 29*4882a593Smuzhiyun TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 30*4882a593Smuzhiyun SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ 31*4882a593Smuzhiyun 32*4882a593Smuzhiyun #ifndef _XTENSA_CORE_TIE_H 33*4882a593Smuzhiyun #define _XTENSA_CORE_TIE_H 34*4882a593Smuzhiyun 35*4882a593Smuzhiyun #define XCHAL_CP_NUM 1 /* number of coprocessors */ 36*4882a593Smuzhiyun #define XCHAL_CP_MAX 8 /* max CP ID + 1 (0 if none) */ 37*4882a593Smuzhiyun #define XCHAL_CP_MASK 0x80 /* bitmask of all CPs by ID */ 38*4882a593Smuzhiyun #define XCHAL_CP_PORT_MASK 0x80 /* bitmask of only port CPs */ 39*4882a593Smuzhiyun 40*4882a593Smuzhiyun /* Basic parameters of each coprocessor: */ 41*4882a593Smuzhiyun #define XCHAL_CP7_NAME "XTIOP" 42*4882a593Smuzhiyun #define XCHAL_CP7_IDENT XTIOP 43*4882a593Smuzhiyun #define XCHAL_CP7_SA_SIZE 0 /* size of state save area */ 44*4882a593Smuzhiyun #define XCHAL_CP7_SA_ALIGN 1 /* min alignment of save area */ 45*4882a593Smuzhiyun #define XCHAL_CP_ID_XTIOP 7 /* coprocessor ID (0..7) */ 46*4882a593Smuzhiyun 47*4882a593Smuzhiyun /* Filler info for unassigned coprocessors, to simplify arrays etc: */ 48*4882a593Smuzhiyun #define XCHAL_CP0_SA_SIZE 0 49*4882a593Smuzhiyun #define XCHAL_CP0_SA_ALIGN 1 50*4882a593Smuzhiyun #define XCHAL_CP1_SA_SIZE 0 51*4882a593Smuzhiyun #define XCHAL_CP1_SA_ALIGN 1 52*4882a593Smuzhiyun #define XCHAL_CP2_SA_SIZE 0 53*4882a593Smuzhiyun #define XCHAL_CP2_SA_ALIGN 1 54*4882a593Smuzhiyun #define XCHAL_CP3_SA_SIZE 0 55*4882a593Smuzhiyun #define XCHAL_CP3_SA_ALIGN 1 56*4882a593Smuzhiyun #define XCHAL_CP4_SA_SIZE 0 57*4882a593Smuzhiyun #define XCHAL_CP4_SA_ALIGN 1 58*4882a593Smuzhiyun #define XCHAL_CP5_SA_SIZE 0 59*4882a593Smuzhiyun #define XCHAL_CP5_SA_ALIGN 1 60*4882a593Smuzhiyun #define XCHAL_CP6_SA_SIZE 0 61*4882a593Smuzhiyun #define XCHAL_CP6_SA_ALIGN 1 62*4882a593Smuzhiyun 63*4882a593Smuzhiyun /* Save area for non-coprocessor optional and custom (TIE) state: */ 64*4882a593Smuzhiyun #define XCHAL_NCP_SA_SIZE 32 65*4882a593Smuzhiyun #define XCHAL_NCP_SA_ALIGN 4 66*4882a593Smuzhiyun 67*4882a593Smuzhiyun /* Total save area for optional and custom state (NCP + CPn): */ 68*4882a593Smuzhiyun #define XCHAL_TOTAL_SA_SIZE 32 /* with 16-byte align padding */ 69*4882a593Smuzhiyun #define XCHAL_TOTAL_SA_ALIGN 4 /* actual minimum alignment */ 70*4882a593Smuzhiyun 71*4882a593Smuzhiyun /* 72*4882a593Smuzhiyun * Detailed contents of save areas. 73*4882a593Smuzhiyun * NOTE: caller must define the XCHAL_SA_REG macro (not defined here) 74*4882a593Smuzhiyun * before expanding the XCHAL_xxx_SA_LIST() macros. 75*4882a593Smuzhiyun * 76*4882a593Smuzhiyun * XCHAL_SA_REG(s,ccused,abikind,kind,opt,name,galign,align,asize, 77*4882a593Smuzhiyun * dbnum,base,regnum,bitsz,gapsz,reset,x...) 78*4882a593Smuzhiyun * 79*4882a593Smuzhiyun * s = passed from XCHAL_*_LIST(s), eg. to select how to expand 80*4882a593Smuzhiyun * ccused = set if used by compiler without special options or code 81*4882a593Smuzhiyun * abikind = 0 (caller-saved), 1 (callee-saved), or 2 (thread-global) 82*4882a593Smuzhiyun * kind = 0 (special reg), 1 (TIE user reg), or 2 (TIE regfile reg) 83*4882a593Smuzhiyun * opt = 0 (custom TIE extension or coprocessor), or 1 (optional reg) 84*4882a593Smuzhiyun * name = lowercase reg name (no quotes) 85*4882a593Smuzhiyun * galign = group byte alignment (power of 2) (galign >= align) 86*4882a593Smuzhiyun * align = register byte alignment (power of 2) 87*4882a593Smuzhiyun * asize = allocated size in bytes (asize*8 == bitsz + gapsz + padsz) 88*4882a593Smuzhiyun * (not including any pad bytes required to galign this or next reg) 89*4882a593Smuzhiyun * dbnum = unique target number f/debug (see <xtensa-libdb-macros.h>) 90*4882a593Smuzhiyun * base = reg shortname w/o index (or sr=special, ur=TIE user reg) 91*4882a593Smuzhiyun * regnum = reg index in regfile, or special/TIE-user reg number 92*4882a593Smuzhiyun * bitsz = number of significant bits (regfile width, or ur/sr mask bits) 93*4882a593Smuzhiyun * gapsz = intervening bits, if bitsz bits not stored contiguously 94*4882a593Smuzhiyun * (padsz = pad bits at end [TIE regfile] or at msbits [ur,sr] of asize) 95*4882a593Smuzhiyun * reset = register reset value (or 0 if undefined at reset) 96*4882a593Smuzhiyun * x = reserved for future use (0 until then) 97*4882a593Smuzhiyun * 98*4882a593Smuzhiyun * To filter out certain registers, e.g. to expand only the non-global 99*4882a593Smuzhiyun * registers used by the compiler, you can do something like this: 100*4882a593Smuzhiyun * 101*4882a593Smuzhiyun * #define XCHAL_SA_REG(s,ccused,p...) SELCC##ccused(p) 102*4882a593Smuzhiyun * #define SELCC0(p...) 103*4882a593Smuzhiyun * #define SELCC1(abikind,p...) SELAK##abikind(p) 104*4882a593Smuzhiyun * #define SELAK0(p...) REG(p) 105*4882a593Smuzhiyun * #define SELAK1(p...) REG(p) 106*4882a593Smuzhiyun * #define SELAK2(p...) 107*4882a593Smuzhiyun * #define REG(kind,tie,name,galn,aln,asz,csz,dbnum,base,rnum,bsz,rst,x...) \ 108*4882a593Smuzhiyun * ...what you want to expand... 109*4882a593Smuzhiyun */ 110*4882a593Smuzhiyun 111*4882a593Smuzhiyun #define XCHAL_NCP_SA_NUM 8 112*4882a593Smuzhiyun #define XCHAL_NCP_SA_LIST(s) \ 113*4882a593Smuzhiyun XCHAL_SA_REG(s,1,2,1,1, threadptr, 4, 4, 4,0x03E7, ur,231, 32,0,0,0) \ 114*4882a593Smuzhiyun XCHAL_SA_REG(s,1,0,0,1, acclo, 4, 4, 4,0x0210, sr,16 , 32,0,0,0) \ 115*4882a593Smuzhiyun XCHAL_SA_REG(s,1,0,0,1, acchi, 4, 4, 4,0x0211, sr,17 , 8,0,0,0) \ 116*4882a593Smuzhiyun XCHAL_SA_REG(s,0,0,0,1, m0, 4, 4, 4,0x0220, sr,32 , 32,0,0,0) \ 117*4882a593Smuzhiyun XCHAL_SA_REG(s,0,0,0,1, m1, 4, 4, 4,0x0221, sr,33 , 32,0,0,0) \ 118*4882a593Smuzhiyun XCHAL_SA_REG(s,0,0,0,1, m2, 4, 4, 4,0x0222, sr,34 , 32,0,0,0) \ 119*4882a593Smuzhiyun XCHAL_SA_REG(s,0,0,0,1, m3, 4, 4, 4,0x0223, sr,35 , 32,0,0,0) \ 120*4882a593Smuzhiyun XCHAL_SA_REG(s,0,0,0,1, scompare1, 4, 4, 4,0x020C, sr,12 , 32,0,0,0) 121*4882a593Smuzhiyun 122*4882a593Smuzhiyun #define XCHAL_CP0_SA_NUM 0 123*4882a593Smuzhiyun #define XCHAL_CP0_SA_LIST(s) /* empty */ 124*4882a593Smuzhiyun 125*4882a593Smuzhiyun #define XCHAL_CP1_SA_NUM 0 126*4882a593Smuzhiyun #define XCHAL_CP1_SA_LIST(s) /* empty */ 127*4882a593Smuzhiyun 128*4882a593Smuzhiyun #define XCHAL_CP2_SA_NUM 0 129*4882a593Smuzhiyun #define XCHAL_CP2_SA_LIST(s) /* empty */ 130*4882a593Smuzhiyun 131*4882a593Smuzhiyun #define XCHAL_CP3_SA_NUM 0 132*4882a593Smuzhiyun #define XCHAL_CP3_SA_LIST(s) /* empty */ 133*4882a593Smuzhiyun 134*4882a593Smuzhiyun #define XCHAL_CP4_SA_NUM 0 135*4882a593Smuzhiyun #define XCHAL_CP4_SA_LIST(s) /* empty */ 136*4882a593Smuzhiyun 137*4882a593Smuzhiyun #define XCHAL_CP5_SA_NUM 0 138*4882a593Smuzhiyun #define XCHAL_CP5_SA_LIST(s) /* empty */ 139*4882a593Smuzhiyun 140*4882a593Smuzhiyun #define XCHAL_CP6_SA_NUM 0 141*4882a593Smuzhiyun #define XCHAL_CP6_SA_LIST(s) /* empty */ 142*4882a593Smuzhiyun 143*4882a593Smuzhiyun #define XCHAL_CP7_SA_NUM 0 144*4882a593Smuzhiyun #define XCHAL_CP7_SA_LIST(s) /* empty */ 145*4882a593Smuzhiyun 146*4882a593Smuzhiyun /* Byte length of instruction from its first nibble (op0 field), per FLIX. */ 147*4882a593Smuzhiyun #define XCHAL_OP0_FORMAT_LENGTHS 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3 148*4882a593Smuzhiyun 149*4882a593Smuzhiyun #endif /*_XTENSA_CORE_TIE_H*/ 150*4882a593Smuzhiyun 151