xref: /OK3568_Linux_fs/kernel/arch/xtensa/variants/dc233c/include/variant/tie.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
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