* mips.h: Improve comments describing the bitfield instruction
[deliverable/binutils-gdb.git] / include / opcode / mips.h
CommitLineData
252b5132 1/* mips.h. Mips opcode list for GDB, the GNU debugger.
c3aa17e9
AM
2 Copyright 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
3 2003, 2004, 2005
4f1d9bd8 4 Free Software Foundation, Inc.
252b5132
RH
5 Contributed by Ralph Campbell and OSF
6 Commented and modified by Ian Lance Taylor, Cygnus Support
7
8This file is part of GDB, GAS, and the GNU binutils.
9
10GDB, GAS, and the GNU binutils are free software; you can redistribute
11them and/or modify them under the terms of the GNU General Public
12License as published by the Free Software Foundation; either version
131, or (at your option) any later version.
14
15GDB, GAS, and the GNU binutils are distributed in the hope that they
16will be useful, but WITHOUT ANY WARRANTY; without even the implied
17warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
18the GNU General Public License for more details.
19
20You should have received a copy of the GNU General Public License
21along with this file; see the file COPYING. If not, write to the Free
e172dbf8 22Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA. */
252b5132
RH
23
24#ifndef _MIPS_H_
25#define _MIPS_H_
26
27/* These are bit masks and shift counts to use to access the various
28 fields of an instruction. To retrieve the X field of an
29 instruction, use the expression
30 (i >> OP_SH_X) & OP_MASK_X
31 To set the same field (to j), use
32 i = (i &~ (OP_MASK_X << OP_SH_X)) | (j << OP_SH_X)
33
34 Make sure you use fields that are appropriate for the instruction,
8eaec934 35 of course.
252b5132 36
8eaec934 37 The 'i' format uses OP, RS, RT and IMMEDIATE.
252b5132
RH
38
39 The 'j' format uses OP and TARGET.
40
41 The 'r' format uses OP, RS, RT, RD, SHAMT and FUNCT.
42
43 The 'b' format uses OP, RS, RT and DELTA.
44
45 The floating point 'i' format uses OP, RS, RT and IMMEDIATE.
46
47 The floating point 'r' format uses OP, FMT, FT, FS, FD and FUNCT.
48
49 A breakpoint instruction uses OP, CODE and SPEC (10 bits of the
50 breakpoint instruction are not defined; Kane says the breakpoint
51 code field in BREAK is 20 bits; yet MIPS assemblers and debuggers
52 only use ten bits). An optional two-operand form of break/sdbbp
4372b673
NC
53 allows the lower ten bits to be set too, and MIPS32 and later
54 architectures allow 20 bits to be set with a signal operand
55 (using CODE20).
252b5132 56
4372b673 57 The syscall instruction uses CODE20.
252b5132
RH
58
59 The general coprocessor instructions use COPZ. */
60
61#define OP_MASK_OP 0x3f
62#define OP_SH_OP 26
63#define OP_MASK_RS 0x1f
64#define OP_SH_RS 21
65#define OP_MASK_FR 0x1f
66#define OP_SH_FR 21
67#define OP_MASK_FMT 0x1f
68#define OP_SH_FMT 21
69#define OP_MASK_BCC 0x7
70#define OP_SH_BCC 18
71#define OP_MASK_CODE 0x3ff
72#define OP_SH_CODE 16
73#define OP_MASK_CODE2 0x3ff
74#define OP_SH_CODE2 6
75#define OP_MASK_RT 0x1f
76#define OP_SH_RT 16
77#define OP_MASK_FT 0x1f
78#define OP_SH_FT 16
79#define OP_MASK_CACHE 0x1f
80#define OP_SH_CACHE 16
81#define OP_MASK_RD 0x1f
82#define OP_SH_RD 11
83#define OP_MASK_FS 0x1f
84#define OP_SH_FS 11
85#define OP_MASK_PREFX 0x1f
86#define OP_SH_PREFX 11
87#define OP_MASK_CCC 0x7
88#define OP_SH_CCC 8
4372b673
NC
89#define OP_MASK_CODE20 0xfffff /* 20 bit syscall/breakpoint code. */
90#define OP_SH_CODE20 6
252b5132
RH
91#define OP_MASK_SHAMT 0x1f
92#define OP_SH_SHAMT 6
93#define OP_MASK_FD 0x1f
94#define OP_SH_FD 6
95#define OP_MASK_TARGET 0x3ffffff
96#define OP_SH_TARGET 0
97#define OP_MASK_COPZ 0x1ffffff
98#define OP_SH_COPZ 0
99#define OP_MASK_IMMEDIATE 0xffff
100#define OP_SH_IMMEDIATE 0
101#define OP_MASK_DELTA 0xffff
102#define OP_SH_DELTA 0
103#define OP_MASK_FUNCT 0x3f
104#define OP_SH_FUNCT 0
105#define OP_MASK_SPEC 0x3f
106#define OP_SH_SPEC 0
4372b673
NC
107#define OP_SH_LOCC 8 /* FP condition code. */
108#define OP_SH_HICC 18 /* FP condition code. */
252b5132 109#define OP_MASK_CC 0x7
4372b673
NC
110#define OP_SH_COP1NORM 25 /* Normal COP1 encoding. */
111#define OP_MASK_COP1NORM 0x1 /* a single bit. */
112#define OP_SH_COP1SPEC 21 /* COP1 encodings. */
252b5132
RH
113#define OP_MASK_COP1SPEC 0xf
114#define OP_MASK_COP1SCLR 0x4
115#define OP_MASK_COP1CMP 0x3
116#define OP_SH_COP1CMP 4
4372b673 117#define OP_SH_FORMAT 21 /* FP short format field. */
252b5132
RH
118#define OP_MASK_FORMAT 0x7
119#define OP_SH_TRUE 16
120#define OP_MASK_TRUE 0x1
121#define OP_SH_GE 17
122#define OP_MASK_GE 0x01
123#define OP_SH_UNSIGNED 16
124#define OP_MASK_UNSIGNED 0x1
125#define OP_SH_HINT 16
126#define OP_MASK_HINT 0x1f
4372b673 127#define OP_SH_MMI 0 /* Multimedia (parallel) op. */
8eaec934 128#define OP_MASK_MMI 0x3f
252b5132
RH
129#define OP_SH_MMISUB 6
130#define OP_MASK_MMISUB 0x1f
4372b673 131#define OP_MASK_PERFREG 0x1f /* Performance monitoring. */
252b5132 132#define OP_SH_PERFREG 1
4372b673
NC
133#define OP_SH_SEL 0 /* Coprocessor select field. */
134#define OP_MASK_SEL 0x7 /* The sel field of mfcZ and mtcZ. */
135#define OP_SH_CODE19 6 /* 19 bit wait code. */
136#define OP_MASK_CODE19 0x7ffff
deec1734
CD
137#define OP_SH_ALN 21
138#define OP_MASK_ALN 0x7
139#define OP_SH_VSEL 21
140#define OP_MASK_VSEL 0x1f
9752cf1b
RS
141#define OP_MASK_VECBYTE 0x7 /* Selector field is really 4 bits,
142 but 0x8-0xf don't select bytes. */
143#define OP_SH_VECBYTE 22
144#define OP_MASK_VECALIGN 0x7 /* Vector byte-align (alni.ob) op. */
145#define OP_SH_VECALIGN 21
af7ee8bf
CD
146#define OP_MASK_INSMSB 0x1f /* "ins" MSB. */
147#define OP_SH_INSMSB 11
148#define OP_MASK_EXTMSBD 0x1f /* "ext" MSBD. */
149#define OP_SH_EXTMSBD 11
deec1734 150
93c34b9b
CF
151/* MIPS DSP ASE */
152#define OP_SH_DSPACC 11
153#define OP_MASK_DSPACC 0x3
154#define OP_SH_DSPACC_S 21
155#define OP_MASK_DSPACC_S 0x3
156#define OP_SH_DSPSFT 20
157#define OP_MASK_DSPSFT 0x3f
158#define OP_SH_DSPSFT_7 19
159#define OP_MASK_DSPSFT_7 0x7f
160#define OP_SH_SA3 21
161#define OP_MASK_SA3 0x7
162#define OP_SH_SA4 21
163#define OP_MASK_SA4 0xf
164#define OP_SH_IMM8 16
165#define OP_MASK_IMM8 0xff
166#define OP_SH_IMM10 16
167#define OP_MASK_IMM10 0x3ff
168#define OP_SH_WRDSP 11
169#define OP_MASK_WRDSP 0x3f
170#define OP_SH_RDDSP 16
171#define OP_MASK_RDDSP 0x3f
172
089b39de
CF
173/* MIPS MT ASE */
174#define OP_SH_MT_U 5
175#define OP_MASK_MT_U 0x1
176#define OP_SH_MT_H 4
177#define OP_MASK_MT_H 0x1
178#define OP_SH_MTACC_T 18
179#define OP_MASK_MTACC_T 0x3
180#define OP_SH_MTACC_D 13
181#define OP_MASK_MTACC_D 0x3
182
640c0ccd
CD
183#define OP_OP_COP0 0x10
184#define OP_OP_COP1 0x11
185#define OP_OP_COP2 0x12
186#define OP_OP_COP3 0x13
187#define OP_OP_LWC1 0x31
188#define OP_OP_LWC2 0x32
189#define OP_OP_LWC3 0x33 /* a.k.a. pref */
190#define OP_OP_LDC1 0x35
191#define OP_OP_LDC2 0x36
192#define OP_OP_LDC3 0x37 /* a.k.a. ld */
193#define OP_OP_SWC1 0x39
194#define OP_OP_SWC2 0x3a
195#define OP_OP_SWC3 0x3b
196#define OP_OP_SDC1 0x3d
197#define OP_OP_SDC2 0x3e
198#define OP_OP_SDC3 0x3f /* a.k.a. sd */
199
deec1734
CD
200/* Values in the 'VSEL' field. */
201#define MDMX_FMTSEL_IMM_QH 0x1d
202#define MDMX_FMTSEL_IMM_OB 0x1e
203#define MDMX_FMTSEL_VEC_QH 0x15
204#define MDMX_FMTSEL_VEC_OB 0x16
4372b673 205
252b5132
RH
206/* This structure holds information for a particular instruction. */
207
208struct mips_opcode
209{
210 /* The name of the instruction. */
211 const char *name;
212 /* A string describing the arguments for this instruction. */
213 const char *args;
214 /* The basic opcode for the instruction. When assembling, this
215 opcode is modified by the arguments to produce the actual opcode
216 that is used. If pinfo is INSN_MACRO, then this is 0. */
217 unsigned long match;
218 /* If pinfo is not INSN_MACRO, then this is a bit mask for the
219 relevant portions of the opcode when disassembling. If the
220 actual opcode anded with the match field equals the opcode field,
221 then we have found the correct instruction. If pinfo is
222 INSN_MACRO, then this field is the macro identifier. */
223 unsigned long mask;
224 /* For a macro, this is INSN_MACRO. Otherwise, it is a collection
225 of bits describing the instruction, notably any relevant hazard
226 information. */
227 unsigned long pinfo;
dc9a9f39
FF
228 /* A collection of additional bits describing the instruction. */
229 unsigned long pinfo2;
252b5132
RH
230 /* A collection of bits describing the instruction sets of which this
231 instruction or macro is a member. */
232 unsigned long membership;
233};
234
27abff54 235/* These are the characters which may appear in the args field of an
252b5132
RH
236 instruction. They appear in the order in which the fields appear
237 when the instruction is used. Commas and parentheses in the args
238 string are ignored when assembling, and written into the output
239 when disassembling.
240
241 Each of these characters corresponds to a mask field defined above.
242
243 "<" 5 bit shift amount (OP_*_SHAMT)
244 ">" shift amount between 32 and 63, stored after subtracting 32 (OP_*_SHAMT)
245 "a" 26 bit target address (OP_*_TARGET)
246 "b" 5 bit base register (OP_*_RS)
247 "c" 10 bit breakpoint code (OP_*_CODE)
248 "d" 5 bit destination register specifier (OP_*_RD)
249 "h" 5 bit prefx hint (OP_*_PREFX)
250 "i" 16 bit unsigned immediate (OP_*_IMMEDIATE)
251 "j" 16 bit signed immediate (OP_*_DELTA)
252 "k" 5 bit cache opcode in target register position (OP_*_CACHE)
9752cf1b 253 Also used for immediate operands in vr5400 vector insns.
252b5132
RH
254 "o" 16 bit signed offset (OP_*_DELTA)
255 "p" 16 bit PC relative branch target address (OP_*_DELTA)
256 "q" 10 bit extra breakpoint code (OP_*_CODE2)
257 "r" 5 bit same register used as both source and target (OP_*_RS)
258 "s" 5 bit source register specifier (OP_*_RS)
259 "t" 5 bit target register (OP_*_RT)
260 "u" 16 bit upper 16 bits of address (OP_*_IMMEDIATE)
261 "v" 5 bit same register used as both source and destination (OP_*_RS)
262 "w" 5 bit same register used as both target and destination (OP_*_RT)
4372b673
NC
263 "U" 5 bit same destination register in both OP_*_RD and OP_*_RT
264 (used by clo and clz)
252b5132 265 "C" 25 bit coprocessor function code (OP_*_COPZ)
4372b673
NC
266 "B" 20 bit syscall/breakpoint function code (OP_*_CODE20)
267 "J" 19 bit wait function code (OP_*_CODE19)
252b5132
RH
268 "x" accept and ignore register name
269 "z" must be zero register
af7ee8bf 270 "K" 5 bit Hardware Register (rdhwr instruction) (OP_*_RD)
ef0ee844
TS
271 "+A" 5 bit ins/ext/dins/dext/dinsm/dextm position, which becomes
272 LSB (OP_*_SHAMT).
071742cf 273 Enforces: 0 <= pos < 32.
ef0ee844 274 "+B" 5 bit ins/dins size, which becomes MSB (OP_*_INSMSB).
5f74bc13 275 Requires that "+A" or "+E" occur first to set position.
071742cf 276 Enforces: 0 < (pos+size) <= 32.
ef0ee844 277 "+C" 5 bit ext/dext size, which becomes MSBD (OP_*_EXTMSBD).
5f74bc13 278 Requires that "+A" or "+E" occur first to set position.
071742cf 279 Enforces: 0 < (pos+size) <= 32.
5f74bc13
CD
280 (Also used by "dext" w/ different limits, but limits for
281 that are checked by the M_DEXT macro.)
ef0ee844 282 "+E" 5 bit dinsu/dextu position, which becomes LSB-32 (OP_*_SHAMT).
5f74bc13 283 Enforces: 32 <= pos < 64.
ef0ee844 284 "+F" 5 bit "dinsm/dinsu" size, which becomes MSB-32 (OP_*_INSMSB).
5f74bc13
CD
285 Requires that "+A" or "+E" occur first to set position.
286 Enforces: 32 < (pos+size) <= 64.
287 "+G" 5 bit "dextm" size, which becomes MSBD-32 (OP_*_EXTMSBD).
288 Requires that "+A" or "+E" occur first to set position.
289 Enforces: 32 < (pos+size) <= 64.
290 "+H" 5 bit "dextu" size, which becomes MSBD (OP_*_EXTMSBD).
291 Requires that "+A" or "+E" occur first to set position.
292 Enforces: 32 < (pos+size) <= 64.
252b5132
RH
293
294 Floating point instructions:
295 "D" 5 bit destination register (OP_*_FD)
296 "M" 3 bit compare condition code (OP_*_CCC) (only used for mips4 and up)
297 "N" 3 bit branch condition code (OP_*_BCC) (only used for mips4 and up)
298 "S" 5 bit fs source 1 register (OP_*_FS)
299 "T" 5 bit ft source 2 register (OP_*_FT)
300 "R" 5 bit fr source 3 register (OP_*_FR)
301 "V" 5 bit same register used as floating source and destination (OP_*_FS)
302 "W" 5 bit same register used as floating target and destination (OP_*_FT)
303
304 Coprocessor instructions:
305 "E" 5 bit target register (OP_*_RT)
306 "G" 5 bit destination register (OP_*_RD)
8ff529d8 307 "H" 3 bit sel field for (d)mtc* and (d)mfc* (OP_*_SEL)
252b5132 308 "P" 5 bit performance-monitor register (OP_*_PERFREG)
9752cf1b
RS
309 "e" 5 bit vector register byte specifier (OP_*_VECBYTE)
310 "%" 3 bit immediate vr5400 vector alignment operand (OP_*_VECALIGN)
311 see also "k" above
bbcc0807
CD
312 "+D" Combined destination register ("G") and sel ("H") for CP0 ops,
313 for pretty-printing in disassembly only.
252b5132
RH
314
315 Macro instructions:
316 "A" General 32 bit expression
5f74bc13
CD
317 "I" 32 bit immediate (value placed in imm_expr).
318 "+I" 32 bit immediate (value placed in imm2_expr).
252b5132
RH
319 "F" 64 bit floating point constant in .rdata
320 "L" 64 bit floating point constant in .lit8
321 "f" 32 bit floating point constant
322 "l" 32 bit floating point constant in .lit4
323
deec1734
CD
324 MDMX instruction operands (note that while these use the FP register
325 fields, they accept both $fN and $vN names for the registers):
326 "O" MDMX alignment offset (OP_*_ALN)
327 "Q" MDMX vector/scalar/immediate source (OP_*_VSEL and OP_*_FT)
328 "X" MDMX destination register (OP_*_FD)
329 "Y" MDMX source register (OP_*_FS)
330 "Z" MDMX source register (OP_*_FT)
331
93c34b9b
CF
332 DSP ASE usage:
333 "3" 3 bit unsigned immediate (OP_*_SA3)
334 "4" 4 bit unsigned immediate (OP_*_SA4)
335 "5" 8 bit unsigned immediate (OP_*_IMM8)
336 "6" 5 bit unsigned immediate (OP_*_RS)
337 "7" 2 bit dsp accumulator register (OP_*_DSPACC)
338 "8" 6 bit unsigned immediate (OP_*_WRDSP)
339 "9" 2 bit dsp accumulator register (OP_*_DSPACC_S)
340 "0" 6 bit signed immediate (OP_*_DSPSFT)
341 ":" 7 bit signed immediate (OP_*_DSPSFT_7)
342 "'" 6 bit unsigned immediate (OP_*_RDDSP)
343 "@" 10 bit signed immediate (OP_*_IMM10)
344
089b39de
CF
345 MT ASE usage:
346 "!" 1 bit immediate at bit 5
347 "$" 1 bit immediate at bit 4
348 "*" 2 bit dsp/smartmips accumulator register (OP_*_MTACC_T)
349 "&" 2 bit dsp/smartmips accumulator register (OP_*_MTACC_D)
350 "g" 5 bit coprocessor 1 and 2 destination register (OP_*_RD)
351 "+t" 5 bit coprocessor 0 destination register (OP_*_RT)
352 "+T" 5 bit coprocessor 0 destination register (OP_*_RT) - disassembly only
353
252b5132
RH
354 Other:
355 "()" parens surrounding optional value
356 "," separates operands
9752cf1b 357 "[]" brackets around index for vector-op scalar operand specifier (vr5400)
af7ee8bf 358 "+" Start of extension sequence.
252b5132
RH
359
360 Characters used so far, for quick reference when adding more:
93c34b9b 361 "34567890"
089b39de 362 "%[]<>(),+:'@!$*&"
af7ee8bf 363 "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
089b39de 364 "abcdefghijklopqrstuvwxz"
af7ee8bf
CD
365
366 Extension character sequences used so far ("+" followed by the
367 following), for quick reference when adding more:
089b39de
CF
368 "ABCDEFGHIT"
369 "t"
252b5132
RH
370*/
371
372/* These are the bits which may be set in the pinfo field of an
373 instructions, if it is not equal to INSN_MACRO. */
374
375/* Modifies the general purpose register in OP_*_RD. */
376#define INSN_WRITE_GPR_D 0x00000001
377/* Modifies the general purpose register in OP_*_RT. */
378#define INSN_WRITE_GPR_T 0x00000002
379/* Modifies general purpose register 31. */
380#define INSN_WRITE_GPR_31 0x00000004
381/* Modifies the floating point register in OP_*_FD. */
382#define INSN_WRITE_FPR_D 0x00000008
383/* Modifies the floating point register in OP_*_FS. */
384#define INSN_WRITE_FPR_S 0x00000010
385/* Modifies the floating point register in OP_*_FT. */
386#define INSN_WRITE_FPR_T 0x00000020
387/* Reads the general purpose register in OP_*_RS. */
388#define INSN_READ_GPR_S 0x00000040
389/* Reads the general purpose register in OP_*_RT. */
390#define INSN_READ_GPR_T 0x00000080
391/* Reads the floating point register in OP_*_FS. */
392#define INSN_READ_FPR_S 0x00000100
393/* Reads the floating point register in OP_*_FT. */
394#define INSN_READ_FPR_T 0x00000200
395/* Reads the floating point register in OP_*_FR. */
396#define INSN_READ_FPR_R 0x00000400
397/* Modifies coprocessor condition code. */
398#define INSN_WRITE_COND_CODE 0x00000800
399/* Reads coprocessor condition code. */
400#define INSN_READ_COND_CODE 0x00001000
401/* TLB operation. */
402#define INSN_TLB 0x00002000
403/* Reads coprocessor register other than floating point register. */
404#define INSN_COP 0x00004000
405/* Instruction loads value from memory, requiring delay. */
406#define INSN_LOAD_MEMORY_DELAY 0x00008000
407/* Instruction loads value from coprocessor, requiring delay. */
408#define INSN_LOAD_COPROC_DELAY 0x00010000
409/* Instruction has unconditional branch delay slot. */
410#define INSN_UNCOND_BRANCH_DELAY 0x00020000
411/* Instruction has conditional branch delay slot. */
412#define INSN_COND_BRANCH_DELAY 0x00040000
413/* Conditional branch likely: if branch not taken, insn nullified. */
414#define INSN_COND_BRANCH_LIKELY 0x00080000
415/* Moves to coprocessor register, requiring delay. */
416#define INSN_COPROC_MOVE_DELAY 0x00100000
417/* Loads coprocessor register from memory, requiring delay. */
418#define INSN_COPROC_MEMORY_DELAY 0x00200000
419/* Reads the HI register. */
420#define INSN_READ_HI 0x00400000
421/* Reads the LO register. */
422#define INSN_READ_LO 0x00800000
423/* Modifies the HI register. */
424#define INSN_WRITE_HI 0x01000000
425/* Modifies the LO register. */
426#define INSN_WRITE_LO 0x02000000
427/* Takes a trap (easier to keep out of delay slot). */
428#define INSN_TRAP 0x04000000
429/* Instruction stores value into memory. */
430#define INSN_STORE_MEMORY 0x08000000
431/* Instruction uses single precision floating point. */
432#define FP_S 0x10000000
433/* Instruction uses double precision floating point. */
434#define FP_D 0x20000000
435/* Instruction is part of the tx39's integer multiply family. */
436#define INSN_MULT 0x40000000
437/* Instruction synchronize shared memory. */
438#define INSN_SYNC 0x80000000
dc9a9f39
FF
439
440/* These are the bits which may be set in the pinfo2 field of an
441 instruction. */
442
443/* Instruction is a simple alias (I.E. "move" for daddu/addu/or) */
239cb185 444#define INSN2_ALIAS 0x00000001
dc9a9f39 445/* Instruction reads MDMX accumulator. */
239cb185 446#define INSN2_READ_MDMX_ACC 0x00000002
dc9a9f39 447/* Instruction writes MDMX accumulator. */
239cb185 448#define INSN2_WRITE_MDMX_ACC 0x00000004
252b5132
RH
449
450/* Instruction is actually a macro. It should be ignored by the
451 disassembler, and requires special treatment by the assembler. */
452#define INSN_MACRO 0xffffffff
453
e7af610e
NC
454/* Masks used to mark instructions to indicate which MIPS ISA level
455 they were introduced in. ISAs, as defined below, are logical
626d0adf 456 ORs of these bits, indicating that they support the instructions
e7af610e
NC
457 defined at the given level. */
458
92714f94 459#define INSN_ISA_MASK 0x00000fff
626d0adf
CD
460#define INSN_ISA1 0x00000001
461#define INSN_ISA2 0x00000002
462#define INSN_ISA3 0x00000004
463#define INSN_ISA4 0x00000008
464#define INSN_ISA5 0x00000010
465#define INSN_ISA32 0x00000020
466#define INSN_ISA64 0x00000040
467#define INSN_ISA32R2 0x00000080
5f74bc13 468#define INSN_ISA64R2 0x00000100
252b5132 469
1f25f5d3 470/* Masks used for MIPS-defined ASEs. */
089b39de 471#define INSN_ASE_MASK 0x0400f000
1f25f5d3 472
93c34b9b
CF
473/* DSP ASE */
474#define INSN_DSP 0x00001000
aec421e0
TS
475/* MIPS 16 ASE */
476#define INSN_MIPS16 0x00002000
1f25f5d3
CD
477/* MIPS-3D ASE */
478#define INSN_MIPS3D 0x00004000
deec1734
CD
479/* MDMX ASE */
480#define INSN_MDMX 0x00008000
1f25f5d3 481
252b5132 482/* Chip specific instructions. These are bitmasks. */
e7af610e 483
252b5132 484/* MIPS R4650 instruction. */
e7af610e 485#define INSN_4650 0x00010000
252b5132 486/* LSI R4010 instruction. */
e7af610e
NC
487#define INSN_4010 0x00020000
488/* NEC VR4100 instruction. */
bf40d919 489#define INSN_4100 0x00040000
252b5132 490/* Toshiba R3900 instruction. */
bf40d919 491#define INSN_3900 0x00080000
99c14723
TS
492/* MIPS R10000 instruction. */
493#define INSN_10000 0x00100000
2228315b
CD
494/* Broadcom SB-1 instruction. */
495#define INSN_SB1 0x00200000
9752cf1b
RS
496/* NEC VR4111/VR4181 instruction. */
497#define INSN_4111 0x00400000
498/* NEC VR4120 instruction. */
499#define INSN_4120 0x00800000
500/* NEC VR5400 instruction. */
501#define INSN_5400 0x01000000
502/* NEC VR5500 instruction. */
503#define INSN_5500 0x02000000
089b39de
CF
504/* MT ASE */
505#define INSN_MT 0x04000000
e7af610e
NC
506
507/* MIPS ISA defines, use instead of hardcoding ISA level. */
508
509#define ISA_UNKNOWN 0 /* Gas internal use. */
510#define ISA_MIPS1 (INSN_ISA1)
511#define ISA_MIPS2 (ISA_MIPS1 | INSN_ISA2)
512#define ISA_MIPS3 (ISA_MIPS2 | INSN_ISA3)
513#define ISA_MIPS4 (ISA_MIPS3 | INSN_ISA4)
84ea6cf2 514#define ISA_MIPS5 (ISA_MIPS4 | INSN_ISA5)
af7ee8bf 515
e7af610e 516#define ISA_MIPS32 (ISA_MIPS2 | INSN_ISA32)
84ea6cf2 517#define ISA_MIPS64 (ISA_MIPS5 | INSN_ISA32 | INSN_ISA64)
367c01af 518
af7ee8bf 519#define ISA_MIPS32R2 (ISA_MIPS32 | INSN_ISA32R2)
5f74bc13
CD
520#define ISA_MIPS64R2 (ISA_MIPS64 | INSN_ISA32R2 | INSN_ISA64R2)
521
af7ee8bf 522
156c2f8b
NC
523/* CPU defines, use instead of hardcoding processor number. Keep this
524 in sync with bfd/archures.c in order for machine selection to work. */
e7af610e 525#define CPU_UNKNOWN 0 /* Gas internal use. */
156c2f8b
NC
526#define CPU_R3000 3000
527#define CPU_R3900 3900
528#define CPU_R4000 4000
529#define CPU_R4010 4010
530#define CPU_VR4100 4100
531#define CPU_R4111 4111
9752cf1b 532#define CPU_VR4120 4120
156c2f8b
NC
533#define CPU_R4300 4300
534#define CPU_R4400 4400
535#define CPU_R4600 4600
536#define CPU_R4650 4650
537#define CPU_R5000 5000
9752cf1b
RS
538#define CPU_VR5400 5400
539#define CPU_VR5500 5500
156c2f8b 540#define CPU_R6000 6000
5a7ea749 541#define CPU_RM7000 7000
156c2f8b 542#define CPU_R8000 8000
98e7aba8 543#define CPU_RM9000 9000
156c2f8b 544#define CPU_R10000 10000
d1cf510e 545#define CPU_R12000 12000
156c2f8b
NC
546#define CPU_MIPS16 16
547#define CPU_MIPS32 32
af7ee8bf 548#define CPU_MIPS32R2 33
84ea6cf2
NC
549#define CPU_MIPS5 5
550#define CPU_MIPS64 64
5f74bc13 551#define CPU_MIPS64R2 65
c6c98b38 552#define CPU_SB1 12310201 /* octal 'SB', 01. */
156c2f8b 553
1f25f5d3
CD
554/* Test for membership in an ISA including chip specific ISAs. INSN
555 is pointer to an element of the opcode table; ISA is the specified
556 ISA/ASE bitmask to test against; and CPU is the CPU specific ISA to
557 test, or zero if no CPU specific ISA test is desired. */
a58ec95a
RS
558
559#define OPCODE_IS_MEMBER(insn, isa, cpu) \
560 (((insn)->membership & isa) != 0 \
156c2f8b 561 || (cpu == CPU_R4650 && ((insn)->membership & INSN_4650) != 0) \
5a7ea749 562 || (cpu == CPU_RM7000 && ((insn)->membership & INSN_4650) != 0) \
98e7aba8 563 || (cpu == CPU_RM9000 && ((insn)->membership & INSN_4650) != 0) \
156c2f8b 564 || (cpu == CPU_R4010 && ((insn)->membership & INSN_4010) != 0) \
9752cf1b 565 || (cpu == CPU_VR4100 && ((insn)->membership & INSN_4100) != 0) \
99c14723
TS
566 || (cpu == CPU_R3900 && ((insn)->membership & INSN_3900) != 0) \
567 || ((cpu == CPU_R10000 || cpu == CPU_R12000) \
2228315b 568 && ((insn)->membership & INSN_10000) != 0) \
5d84d93f 569 || (cpu == CPU_SB1 && ((insn)->membership & INSN_SB1) != 0) \
9752cf1b
RS
570 || (cpu == CPU_R4111 && ((insn)->membership & INSN_4111) != 0) \
571 || (cpu == CPU_VR4120 && ((insn)->membership & INSN_4120) != 0) \
572 || (cpu == CPU_VR5400 && ((insn)->membership & INSN_5400) != 0) \
573 || (cpu == CPU_VR5500 && ((insn)->membership & INSN_5500) != 0) \
e4432525 574 || 0) /* Please keep this term for easier source merging. */
252b5132
RH
575
576/* This is a list of macro expanded instructions.
8eaec934 577
e7af610e
NC
578 _I appended means immediate
579 _A appended means address
580 _AB appended means address with base register
581 _D appended means 64 bit floating point constant
582 _S appended means 32 bit floating point constant. */
583
584enum
585{
586 M_ABS,
587 M_ADD_I,
588 M_ADDU_I,
589 M_AND_I,
590 M_BEQ,
591 M_BEQ_I,
592 M_BEQL_I,
593 M_BGE,
594 M_BGEL,
595 M_BGE_I,
596 M_BGEL_I,
597 M_BGEU,
598 M_BGEUL,
599 M_BGEU_I,
600 M_BGEUL_I,
601 M_BGT,
602 M_BGTL,
603 M_BGT_I,
604 M_BGTL_I,
605 M_BGTU,
606 M_BGTUL,
607 M_BGTU_I,
608 M_BGTUL_I,
609 M_BLE,
610 M_BLEL,
611 M_BLE_I,
612 M_BLEL_I,
613 M_BLEU,
614 M_BLEUL,
615 M_BLEU_I,
616 M_BLEUL_I,
617 M_BLT,
618 M_BLTL,
619 M_BLT_I,
620 M_BLTL_I,
621 M_BLTU,
622 M_BLTUL,
623 M_BLTU_I,
624 M_BLTUL_I,
625 M_BNE,
626 M_BNE_I,
627 M_BNEL_I,
628 M_DABS,
629 M_DADD_I,
630 M_DADDU_I,
631 M_DDIV_3,
632 M_DDIV_3I,
633 M_DDIVU_3,
634 M_DDIVU_3I,
5f74bc13
CD
635 M_DEXT,
636 M_DINS,
e7af610e
NC
637 M_DIV_3,
638 M_DIV_3I,
639 M_DIVU_3,
640 M_DIVU_3I,
641 M_DLA_AB,
1abe91b1 642 M_DLCA_AB,
e7af610e
NC
643 M_DLI,
644 M_DMUL,
8eaec934 645 M_DMUL_I,
e7af610e 646 M_DMULO,
8eaec934 647 M_DMULO_I,
e7af610e 648 M_DMULOU,
8eaec934 649 M_DMULOU_I,
e7af610e
NC
650 M_DREM_3,
651 M_DREM_3I,
652 M_DREMU_3,
653 M_DREMU_3I,
654 M_DSUB_I,
655 M_DSUBU_I,
656 M_DSUBU_I_2,
657 M_J_A,
658 M_JAL_1,
659 M_JAL_2,
660 M_JAL_A,
661 M_L_DOB,
662 M_L_DAB,
663 M_LA_AB,
664 M_LB_A,
665 M_LB_AB,
666 M_LBU_A,
667 M_LBU_AB,
1abe91b1 668 M_LCA_AB,
e7af610e
NC
669 M_LD_A,
670 M_LD_OB,
671 M_LD_AB,
672 M_LDC1_AB,
673 M_LDC2_AB,
674 M_LDC3_AB,
675 M_LDL_AB,
676 M_LDR_AB,
677 M_LH_A,
678 M_LH_AB,
679 M_LHU_A,
680 M_LHU_AB,
681 M_LI,
682 M_LI_D,
683 M_LI_DD,
684 M_LI_S,
685 M_LI_SS,
686 M_LL_AB,
687 M_LLD_AB,
688 M_LS_A,
689 M_LW_A,
690 M_LW_AB,
691 M_LWC0_A,
692 M_LWC0_AB,
693 M_LWC1_A,
694 M_LWC1_AB,
695 M_LWC2_A,
696 M_LWC2_AB,
697 M_LWC3_A,
698 M_LWC3_AB,
699 M_LWL_A,
700 M_LWL_AB,
701 M_LWR_A,
702 M_LWR_AB,
703 M_LWU_AB,
a58ec95a 704 M_MOVE,
e7af610e 705 M_MUL,
8eaec934 706 M_MUL_I,
e7af610e 707 M_MULO,
8eaec934 708 M_MULO_I,
e7af610e 709 M_MULOU,
8eaec934 710 M_MULOU_I,
e7af610e
NC
711 M_NOR_I,
712 M_OR_I,
713 M_REM_3,
714 M_REM_3I,
715 M_REMU_3,
716 M_REMU_3I,
771c7ce4 717 M_DROL,
e7af610e 718 M_ROL,
771c7ce4 719 M_DROL_I,
e7af610e 720 M_ROL_I,
771c7ce4 721 M_DROR,
e7af610e 722 M_ROR,
771c7ce4 723 M_DROR_I,
e7af610e
NC
724 M_ROR_I,
725 M_S_DA,
726 M_S_DOB,
727 M_S_DAB,
728 M_S_S,
729 M_SC_AB,
730 M_SCD_AB,
731 M_SD_A,
732 M_SD_OB,
733 M_SD_AB,
734 M_SDC1_AB,
735 M_SDC2_AB,
736 M_SDC3_AB,
737 M_SDL_AB,
738 M_SDR_AB,
739 M_SEQ,
740 M_SEQ_I,
741 M_SGE,
742 M_SGE_I,
743 M_SGEU,
744 M_SGEU_I,
745 M_SGT,
746 M_SGT_I,
747 M_SGTU,
748 M_SGTU_I,
749 M_SLE,
750 M_SLE_I,
751 M_SLEU,
752 M_SLEU_I,
753 M_SLT_I,
754 M_SLTU_I,
755 M_SNE,
756 M_SNE_I,
757 M_SB_A,
758 M_SB_AB,
759 M_SH_A,
760 M_SH_AB,
761 M_SW_A,
762 M_SW_AB,
763 M_SWC0_A,
764 M_SWC0_AB,
765 M_SWC1_A,
766 M_SWC1_AB,
767 M_SWC2_A,
768 M_SWC2_AB,
769 M_SWC3_A,
770 M_SWC3_AB,
771 M_SWL_A,
772 M_SWL_AB,
773 M_SWR_A,
774 M_SWR_AB,
775 M_SUB_I,
776 M_SUBU_I,
777 M_SUBU_I_2,
778 M_TEQ_I,
779 M_TGE_I,
780 M_TGEU_I,
781 M_TLT_I,
782 M_TLTU_I,
783 M_TNE_I,
784 M_TRUNCWD,
785 M_TRUNCWS,
786 M_ULD,
787 M_ULD_A,
788 M_ULH,
789 M_ULH_A,
790 M_ULHU,
791 M_ULHU_A,
792 M_ULW,
793 M_ULW_A,
794 M_USH,
795 M_USH_A,
796 M_USW,
797 M_USW_A,
798 M_USD,
799 M_USD_A,
800 M_XOR_I,
801 M_COP0,
802 M_COP1,
803 M_COP2,
804 M_COP3,
805 M_NUM_MACROS
252b5132
RH
806};
807
808
809/* The order of overloaded instructions matters. Label arguments and
810 register arguments look the same. Instructions that can have either
811 for arguments must apear in the correct order in this table for the
812 assembler to pick the right one. In other words, entries with
813 immediate operands must apear after the same instruction with
814 registers.
815
816 Many instructions are short hand for other instructions (i.e., The
817 jal <register> instruction is short for jalr <register>). */
818
819extern const struct mips_opcode mips_builtin_opcodes[];
820extern const int bfd_mips_num_builtin_opcodes;
821extern struct mips_opcode *mips_opcodes;
822extern int bfd_mips_num_opcodes;
823#define NUMOPCODES bfd_mips_num_opcodes
824
825\f
826/* The rest of this file adds definitions for the mips16 TinyRISC
827 processor. */
828
829/* These are the bitmasks and shift counts used for the different
830 fields in the instruction formats. Other than OP, no masks are
831 provided for the fixed portions of an instruction, since they are
832 not needed.
833
834 The I format uses IMM11.
835
836 The RI format uses RX and IMM8.
837
838 The RR format uses RX, and RY.
839
840 The RRI format uses RX, RY, and IMM5.
841
842 The RRR format uses RX, RY, and RZ.
843
844 The RRI_A format uses RX, RY, and IMM4.
845
846 The SHIFT format uses RX, RY, and SHAMT.
847
848 The I8 format uses IMM8.
849
850 The I8_MOVR32 format uses RY and REGR32.
851
852 The IR_MOV32R format uses REG32R and MOV32Z.
853
854 The I64 format uses IMM8.
855
856 The RI64 format uses RY and IMM5.
857 */
858
859#define MIPS16OP_MASK_OP 0x1f
860#define MIPS16OP_SH_OP 11
861#define MIPS16OP_MASK_IMM11 0x7ff
862#define MIPS16OP_SH_IMM11 0
863#define MIPS16OP_MASK_RX 0x7
864#define MIPS16OP_SH_RX 8
865#define MIPS16OP_MASK_IMM8 0xff
866#define MIPS16OP_SH_IMM8 0
867#define MIPS16OP_MASK_RY 0x7
868#define MIPS16OP_SH_RY 5
869#define MIPS16OP_MASK_IMM5 0x1f
870#define MIPS16OP_SH_IMM5 0
871#define MIPS16OP_MASK_RZ 0x7
872#define MIPS16OP_SH_RZ 2
873#define MIPS16OP_MASK_IMM4 0xf
874#define MIPS16OP_SH_IMM4 0
875#define MIPS16OP_MASK_REGR32 0x1f
876#define MIPS16OP_SH_REGR32 0
877#define MIPS16OP_MASK_REG32R 0x1f
878#define MIPS16OP_SH_REG32R 3
879#define MIPS16OP_EXTRACT_REG32R(i) ((((i) >> 5) & 7) | ((i) & 0x18))
880#define MIPS16OP_MASK_MOVE32Z 0x7
881#define MIPS16OP_SH_MOVE32Z 0
882#define MIPS16OP_MASK_IMM6 0x3f
883#define MIPS16OP_SH_IMM6 5
884
885/* These are the characters which may appears in the args field of an
886 instruction. They appear in the order in which the fields appear
887 when the instruction is used. Commas and parentheses in the args
888 string are ignored when assembling, and written into the output
889 when disassembling.
890
891 "y" 3 bit register (MIPS16OP_*_RY)
892 "x" 3 bit register (MIPS16OP_*_RX)
893 "z" 3 bit register (MIPS16OP_*_RZ)
894 "Z" 3 bit register (MIPS16OP_*_MOVE32Z)
895 "v" 3 bit same register as source and destination (MIPS16OP_*_RX)
896 "w" 3 bit same register as source and destination (MIPS16OP_*_RY)
897 "0" zero register ($0)
898 "S" stack pointer ($sp or $29)
899 "P" program counter
900 "R" return address register ($ra or $31)
901 "X" 5 bit MIPS register (MIPS16OP_*_REGR32)
902 "Y" 5 bit MIPS register (MIPS16OP_*_REG32R)
903 "6" 6 bit unsigned break code (MIPS16OP_*_IMM6)
904 "a" 26 bit jump address
905 "e" 11 bit extension value
906 "l" register list for entry instruction
907 "L" register list for exit instruction
908
909 The remaining codes may be extended. Except as otherwise noted,
910 the full extended operand is a 16 bit signed value.
911 "<" 3 bit unsigned shift count * 0 (MIPS16OP_*_RZ) (full 5 bit unsigned)
912 ">" 3 bit unsigned shift count * 0 (MIPS16OP_*_RX) (full 5 bit unsigned)
913 "[" 3 bit unsigned shift count * 0 (MIPS16OP_*_RZ) (full 6 bit unsigned)
914 "]" 3 bit unsigned shift count * 0 (MIPS16OP_*_RX) (full 6 bit unsigned)
915 "4" 4 bit signed immediate * 0 (MIPS16OP_*_IMM4) (full 15 bit signed)
916 "5" 5 bit unsigned immediate * 0 (MIPS16OP_*_IMM5)
917 "H" 5 bit unsigned immediate * 2 (MIPS16OP_*_IMM5)
918 "W" 5 bit unsigned immediate * 4 (MIPS16OP_*_IMM5)
919 "D" 5 bit unsigned immediate * 8 (MIPS16OP_*_IMM5)
920 "j" 5 bit signed immediate * 0 (MIPS16OP_*_IMM5)
921 "8" 8 bit unsigned immediate * 0 (MIPS16OP_*_IMM8)
922 "V" 8 bit unsigned immediate * 4 (MIPS16OP_*_IMM8)
923 "C" 8 bit unsigned immediate * 8 (MIPS16OP_*_IMM8)
924 "U" 8 bit unsigned immediate * 0 (MIPS16OP_*_IMM8) (full 16 bit unsigned)
925 "k" 8 bit signed immediate * 0 (MIPS16OP_*_IMM8)
926 "K" 8 bit signed immediate * 8 (MIPS16OP_*_IMM8)
927 "p" 8 bit conditional branch address (MIPS16OP_*_IMM8)
928 "q" 11 bit branch address (MIPS16OP_*_IMM11)
929 "A" 8 bit PC relative address * 4 (MIPS16OP_*_IMM8)
930 "B" 5 bit PC relative address * 8 (MIPS16OP_*_IMM5)
931 "E" 5 bit PC relative address * 4 (MIPS16OP_*_IMM5)
0499d65b
TS
932 "m" 7 bit register list for save instruction (18 bit extended)
933 "M" 7 bit register list for restore instruction (18 bit extended)
934 */
935
936/* Save/restore encoding for the args field when all 4 registers are
937 either saved as arguments or saved/restored as statics. */
938#define MIPS16_ALL_ARGS 0xe
939#define MIPS16_ALL_STATICS 0xb
252b5132
RH
940
941/* For the mips16, we use the same opcode table format and a few of
942 the same flags. However, most of the flags are different. */
943
944/* Modifies the register in MIPS16OP_*_RX. */
945#define MIPS16_INSN_WRITE_X 0x00000001
946/* Modifies the register in MIPS16OP_*_RY. */
947#define MIPS16_INSN_WRITE_Y 0x00000002
948/* Modifies the register in MIPS16OP_*_RZ. */
949#define MIPS16_INSN_WRITE_Z 0x00000004
950/* Modifies the T ($24) register. */
951#define MIPS16_INSN_WRITE_T 0x00000008
952/* Modifies the SP ($29) register. */
953#define MIPS16_INSN_WRITE_SP 0x00000010
954/* Modifies the RA ($31) register. */
955#define MIPS16_INSN_WRITE_31 0x00000020
956/* Modifies the general purpose register in MIPS16OP_*_REG32R. */
957#define MIPS16_INSN_WRITE_GPR_Y 0x00000040
958/* Reads the register in MIPS16OP_*_RX. */
959#define MIPS16_INSN_READ_X 0x00000080
960/* Reads the register in MIPS16OP_*_RY. */
961#define MIPS16_INSN_READ_Y 0x00000100
962/* Reads the register in MIPS16OP_*_MOVE32Z. */
963#define MIPS16_INSN_READ_Z 0x00000200
964/* Reads the T ($24) register. */
965#define MIPS16_INSN_READ_T 0x00000400
966/* Reads the SP ($29) register. */
967#define MIPS16_INSN_READ_SP 0x00000800
968/* Reads the RA ($31) register. */
969#define MIPS16_INSN_READ_31 0x00001000
970/* Reads the program counter. */
971#define MIPS16_INSN_READ_PC 0x00002000
972/* Reads the general purpose register in MIPS16OP_*_REGR32. */
973#define MIPS16_INSN_READ_GPR_X 0x00004000
974/* Is a branch insn. */
975#define MIPS16_INSN_BRANCH 0x00010000
976
977/* The following flags have the same value for the mips16 opcode
978 table:
979 INSN_UNCOND_BRANCH_DELAY
980 INSN_COND_BRANCH_DELAY
981 INSN_COND_BRANCH_LIKELY (never used)
982 INSN_READ_HI
983 INSN_READ_LO
984 INSN_WRITE_HI
985 INSN_WRITE_LO
986 INSN_TRAP
987 INSN_ISA3
988 */
989
990extern const struct mips_opcode mips16_opcodes[];
991extern const int bfd_mips16_num_opcodes;
992
993#endif /* _MIPS_H_ */
This page took 0.312023 seconds and 4 git commands to generate.