2006-03-10 Paul Brook <paul@codesourcery.com>
[external/binutils.git] / include / opcode / arm.h
1 /* ARM assembler/disassembler support.
2    Copyright 2004 Free Software Foundation, Inc.
3
4    This file is part of GDB and GAS.
5
6    GDB and GAS are free software; you can redistribute it and/or
7    modify it under the terms of the GNU General Public License as
8    published by the Free Software Foundation; either version 1, or (at
9    your option) any later version.
10
11    GDB and GAS are distributed in the hope that it will be useful, but
12    WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14    General Public License for more details.
15
16    You should have received a copy of the GNU General Public License
17    along with GDB or GAS; see the file COPYING.  If not, write to the
18    Free Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
19    02110-1301, USA.  */
20
21 /* The following bitmasks control CPU extensions:  */
22 #define ARM_EXT_V1       0x00000001     /* All processors (core set).  */
23 #define ARM_EXT_V2       0x00000002     /* Multiply instructions.  */
24 #define ARM_EXT_V2S      0x00000004     /* SWP instructions.       */
25 #define ARM_EXT_V3       0x00000008     /* MSR MRS.                */
26 #define ARM_EXT_V3M      0x00000010     /* Allow long multiplies.  */
27 #define ARM_EXT_V4       0x00000020     /* Allow half word loads.  */
28 #define ARM_EXT_V4T      0x00000040     /* Thumb.                  */
29 #define ARM_EXT_V5       0x00000080     /* Allow CLZ, etc.         */
30 #define ARM_EXT_V5T      0x00000100     /* Improved interworking.  */
31 #define ARM_EXT_V5ExP    0x00000200     /* DSP core set.           */
32 #define ARM_EXT_V5E      0x00000400     /* DSP Double transfers.   */
33 #define ARM_EXT_V5J      0x00000800     /* Jazelle extension.      */
34 #define ARM_EXT_V6       0x00001000     /* ARM V6.                 */
35 #define ARM_EXT_V6K      0x00002000     /* ARM V6K.                */
36 #define ARM_EXT_V6Z      0x00004000     /* ARM V6Z.                */
37 #define ARM_EXT_V6T2     0x00008000     /* Thumb-2.                */
38 #define ARM_EXT_DIV      0x00010000     /* Integer division.       */
39 /* The 'M' in Arm V7M stands for Microcontroller.
40    On earlier architecture variants it stands for Multiply.  */
41 #define ARM_EXT_V5E_NOTM 0x00020000     /* Arm V5E but not Arm V7M. */
42 #define ARM_EXT_V6_NOTM  0x00040000     /* Arm V6 but not Arm V7M. */
43 #define ARM_EXT_V7       0x00080000     /* Arm V7.                 */
44 #define ARM_EXT_V7A      0x00100000     /* Arm V7A.                */
45 #define ARM_EXT_V7R      0x00200000     /* Arm V7R.                */
46 #define ARM_EXT_V7M      0x00400000     /* Arm V7M.                */
47
48 /* Co-processor space extensions.  */
49 #define ARM_CEXT_XSCALE   0x00000001    /* Allow MIA etc.          */
50 #define ARM_CEXT_MAVERICK 0x00000002    /* Use Cirrus/DSP coprocessor.  */
51 #define ARM_CEXT_IWMMXT   0x00000004    /* Intel Wireless MMX technology coprocessor.   */
52
53 #define FPU_ENDIAN_PURE  0x80000000     /* Pure-endian doubles.       */
54 #define FPU_ENDIAN_BIG   0              /* Double words-big-endian.   */
55 #define FPU_FPA_EXT_V1   0x40000000     /* Base FPA instruction set.  */
56 #define FPU_FPA_EXT_V2   0x20000000     /* LFM/SFM.                   */
57 #define FPU_MAVERICK     0x10000000     /* Cirrus Maverick.           */
58 #define FPU_VFP_EXT_V1xD 0x08000000     /* Base VFP instruction set.  */
59 #define FPU_VFP_EXT_V1   0x04000000     /* Double-precision insns.    */
60 #define FPU_VFP_EXT_V2   0x02000000     /* ARM10E VFPr1.              */
61
62 /* Architectures are the sum of the base and extensions.  The ARM ARM (rev E)
63    defines the following: ARMv3, ARMv3M, ARMv4xM, ARMv4, ARMv4TxM, ARMv4T,
64    ARMv5xM, ARMv5, ARMv5TxM, ARMv5T, ARMv5TExP, ARMv5TE.  To these we add
65    three more to cover cores prior to ARM6.  Finally, there are cores which
66    implement further extensions in the co-processor space.  */
67 #define ARM_AEXT_V1                       ARM_EXT_V1
68 #define ARM_AEXT_V2     (ARM_AEXT_V1    | ARM_EXT_V2)
69 #define ARM_AEXT_V2S    (ARM_AEXT_V2    | ARM_EXT_V2S)
70 #define ARM_AEXT_V3     (ARM_AEXT_V2S   | ARM_EXT_V3)
71 #define ARM_AEXT_V3M    (ARM_AEXT_V3    | ARM_EXT_V3M)
72 #define ARM_AEXT_V4xM   (ARM_AEXT_V3    | ARM_EXT_V4)
73 #define ARM_AEXT_V4     (ARM_AEXT_V3M   | ARM_EXT_V4)
74 #define ARM_AEXT_V4TxM  (ARM_AEXT_V4xM  | ARM_EXT_V4T)
75 #define ARM_AEXT_V4T    (ARM_AEXT_V4    | ARM_EXT_V4T)
76 #define ARM_AEXT_V5xM   (ARM_AEXT_V4xM  | ARM_EXT_V5)
77 #define ARM_AEXT_V5     (ARM_AEXT_V4    | ARM_EXT_V5)
78 #define ARM_AEXT_V5TxM  (ARM_AEXT_V5xM  | ARM_EXT_V4T | ARM_EXT_V5T)
79 #define ARM_AEXT_V5T    (ARM_AEXT_V5    | ARM_EXT_V4T | ARM_EXT_V5T)
80 #define ARM_AEXT_V5TExP (ARM_AEXT_V5T   | ARM_EXT_V5ExP)
81 #define ARM_AEXT_V5TE   (ARM_AEXT_V5TExP | ARM_EXT_V5E)
82 #define ARM_AEXT_V5TEJ  (ARM_AEXT_V5TE  | ARM_EXT_V5J)
83 #define ARM_AEXT_V6     (ARM_AEXT_V5TEJ | ARM_EXT_V6)
84 #define ARM_AEXT_V6K    (ARM_AEXT_V6    | ARM_EXT_V6K)
85 #define ARM_AEXT_V6Z    (ARM_AEXT_V6    | ARM_EXT_V6Z)
86 #define ARM_AEXT_V6ZK   (ARM_AEXT_V6    | ARM_EXT_V6K | ARM_EXT_V6Z)
87 #define ARM_AEXT_V6T2   (ARM_AEXT_V6    | ARM_EXT_V6T2 | ARM_EXT_V6_NOTM)
88 #define ARM_AEXT_V6KT2  (ARM_AEXT_V6T2 | ARM_EXT_V6K)
89 #define ARM_AEXT_V6ZT2  (ARM_AEXT_V6T2 | ARM_EXT_V6Z)
90 #define ARM_AEXT_V6ZKT2 (ARM_AEXT_V6T2 | ARM_EXT_V6K | ARM_EXT_V6Z)
91 #define ARM_AEXT_V7_ARM (ARM_AEXT_V6ZKT2 | ARM_EXT_V7)
92 #define ARM_AEXT_V7A    (ARM_AEXT_V7_ARM | ARM_EXT_V7A)
93 #define ARM_AEXT_V7R    (ARM_AEXT_V7_ARM | ARM_EXT_V7R | ARM_EXT_DIV)
94 #define ARM_AEXT_NOTM \
95   (ARM_AEXT_V4 | ARM_EXT_V5ExP | ARM_EXT_V5J | ARM_EXT_V6_NOTM)
96 #define ARM_AEXT_V7M \
97   ((ARM_AEXT_V7_ARM | ARM_EXT_V7M | ARM_EXT_DIV) & ~(ARM_AEXT_NOTM))
98 #define ARM_AEXT_V7 (ARM_AEXT_V7A & ARM_AEXT_V7R & ARM_AEXT_V7M)
99
100 /* Processors with specific extensions in the co-processor space.  */
101 #define ARM_ARCH_XSCALE ARM_FEATURE (ARM_AEXT_V5TE, ARM_CEXT_XSCALE)
102 #define ARM_ARCH_IWMMXT \
103  ARM_FEATURE (ARM_AEXT_V5TE, ARM_CEXT_XSCALE | ARM_CEXT_IWMMXT)
104
105 #define FPU_VFP_V1xD    (FPU_VFP_EXT_V1xD | FPU_ENDIAN_PURE)
106 #define FPU_VFP_V1      (FPU_VFP_V1xD | FPU_VFP_EXT_V1)
107 #define FPU_VFP_V2      (FPU_VFP_V1 | FPU_VFP_EXT_V2)
108 #define FPU_VFP_HARD    (FPU_VFP_EXT_V1xD | FPU_VFP_EXT_V1 | FPU_VFP_EXT_V2)
109 #define FPU_FPA         (FPU_FPA_EXT_V1 | FPU_FPA_EXT_V2)
110
111 /* Deprecated */
112 #define FPU_ARCH_VFP    ARM_FEATURE (0, FPU_ENDIAN_PURE)
113
114 #define FPU_ARCH_FPE    ARM_FEATURE (0, FPU_FPA_EXT_V1)
115 #define FPU_ARCH_FPA    ARM_FEATURE (0, FPU_FPA)
116
117 #define FPU_ARCH_VFP_V1xD ARM_FEATURE (0, FPU_VFP_V1xD)
118 #define FPU_ARCH_VFP_V1   ARM_FEATURE (0, FPU_VFP_V1)
119 #define FPU_ARCH_VFP_V2   ARM_FEATURE (0, FPU_VFP_V2)
120 #define FPU_ARCH_VFP_HARD ARM_FEATURE (0, FPU_VFP_HARD)
121
122 #define FPU_ARCH_ENDIAN_PURE ARM_FEATURE (0, FPU_ENDIAN_PURE)
123
124 #define FPU_ARCH_MAVERICK ARM_FEATURE (0, FPU_MAVERICK)
125
126 #define ARM_ARCH_V1     ARM_FEATURE (ARM_AEXT_V1, 0)
127 #define ARM_ARCH_V2     ARM_FEATURE (ARM_AEXT_V2, 0)
128 #define ARM_ARCH_V2S    ARM_FEATURE (ARM_AEXT_V2S, 0)
129 #define ARM_ARCH_V3     ARM_FEATURE (ARM_AEXT_V3, 0)
130 #define ARM_ARCH_V3M    ARM_FEATURE (ARM_AEXT_V3M, 0)
131 #define ARM_ARCH_V4xM   ARM_FEATURE (ARM_AEXT_V4xM, 0)
132 #define ARM_ARCH_V4     ARM_FEATURE (ARM_AEXT_V4, 0)
133 #define ARM_ARCH_V4TxM  ARM_FEATURE (ARM_AEXT_V4TxM, 0)
134 #define ARM_ARCH_V4T    ARM_FEATURE (ARM_AEXT_V4T, 0)
135 #define ARM_ARCH_V5xM   ARM_FEATURE (ARM_AEXT_V5xM, 0)
136 #define ARM_ARCH_V5     ARM_FEATURE (ARM_AEXT_V5, 0)
137 #define ARM_ARCH_V5TxM  ARM_FEATURE (ARM_AEXT_V5TxM, 0)
138 #define ARM_ARCH_V5T    ARM_FEATURE (ARM_AEXT_V5T, 0)
139 #define ARM_ARCH_V5TExP ARM_FEATURE (ARM_AEXT_V5TExP, 0)
140 #define ARM_ARCH_V5TE   ARM_FEATURE (ARM_AEXT_V5TE, 0)
141 #define ARM_ARCH_V5TEJ  ARM_FEATURE (ARM_AEXT_V5TEJ, 0)
142 #define ARM_ARCH_V6     ARM_FEATURE (ARM_AEXT_V6, 0)
143 #define ARM_ARCH_V6K    ARM_FEATURE (ARM_AEXT_V6K, 0)
144 #define ARM_ARCH_V6Z    ARM_FEATURE (ARM_AEXT_V6Z, 0)
145 #define ARM_ARCH_V6ZK   ARM_FEATURE (ARM_AEXT_V6ZK, 0)
146 #define ARM_ARCH_V6T2   ARM_FEATURE (ARM_AEXT_V6T2, 0)
147 #define ARM_ARCH_V6KT2  ARM_FEATURE (ARM_AEXT_V6KT2, 0)
148 #define ARM_ARCH_V6ZT2  ARM_FEATURE (ARM_AEXT_V6ZT2, 0)
149 #define ARM_ARCH_V6ZKT2 ARM_FEATURE (ARM_AEXT_V6ZKT2, 0)
150 #define ARM_ARCH_V7     ARM_FEATURE (ARM_AEXT_V7, 0)
151 #define ARM_ARCH_V7A    ARM_FEATURE (ARM_AEXT_V7A, 0)
152 #define ARM_ARCH_V7R    ARM_FEATURE (ARM_AEXT_V7R, 0)
153 #define ARM_ARCH_V7M    ARM_FEATURE (ARM_AEXT_V7M, 0)
154
155 /* Some useful combinations:  */
156 #define ARM_ARCH_NONE   ARM_FEATURE (0, 0)
157 #define FPU_NONE        ARM_FEATURE (0, 0)
158 #define ARM_ANY         ARM_FEATURE (-1, 0)     /* Any basic core.  */
159 #define FPU_ANY_HARD    ARM_FEATURE (0, FPU_FPA | FPU_VFP_HARD | FPU_MAVERICK)
160 #define ARM_ARCH_THUMB2 ARM_FEATURE (ARM_EXT_V6T2 | ARM_EXT_V7 | ARM_EXT_V7A | ARM_EXT_V7R | ARM_EXT_V7M | ARM_EXT_DIV, 0)
161
162 /* There are too many feature bits to fit in a single word, so use a
163    structure.  For simplicity we put all core features in one word and
164    everything else in the other.  */
165 typedef struct
166 {
167   unsigned long core;
168   unsigned long coproc;
169 } arm_feature_set;
170
171 #define ARM_CPU_HAS_FEATURE(CPU,FEAT) \
172   (((CPU).core & (FEAT).core) != 0 || ((CPU).coproc & (FEAT).coproc) != 0)
173
174 #define ARM_MERGE_FEATURE_SETS(TARG,F1,F2)      \
175   do {                                          \
176     (TARG).core = (F1).core | (F2).core;        \
177     (TARG).coproc = (F1).coproc | (F2).coproc;  \
178   } while (0)
179
180 #define ARM_CLEAR_FEATURE(TARG,F1,F2)           \
181   do {                                          \
182     (TARG).core = (F1).core &~ (F2).core;       \
183     (TARG).coproc = (F1).coproc &~ (F2).coproc; \
184   } while (0)
185
186 #define ARM_FEATURE(core, coproc) {(core), (coproc)}