]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame - include/opcode/mips.h
compare-sections: New -r option.
[thirdparty/binutils-gdb.git] / include / opcode / mips.h
CommitLineData
252b5132 1/* mips.h. Mips opcode list for GDB, the GNU debugger.
4b95cf5c 2 Copyright (C) 1993-2014 Free Software Foundation, Inc.
252b5132
RH
3 Contributed by Ralph Campbell and OSF
4 Commented and modified by Ian Lance Taylor, Cygnus Support
5
e4e42b45 6 This file is part of GDB, GAS, and the GNU binutils.
252b5132 7
e4e42b45
NC
8 GDB, GAS, and the GNU binutils are free software; you can redistribute
9 them and/or modify them under the terms of the GNU General Public
10 License as published by the Free Software Foundation; either version 3,
11 or (at your option) any later version.
252b5132 12
e4e42b45
NC
13 GDB, GAS, and the GNU binutils are distributed in the hope that they
14 will be useful, but WITHOUT ANY WARRANTY; without even the implied
15 warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
16 the GNU General Public License for more details.
252b5132 17
e4e42b45
NC
18 You should have received a copy of the GNU General Public License
19 along with this file; see the file COPYING3. If not, write to the Free
20 Software Foundation, 51 Franklin Street - Fifth Floor, Boston,
21 MA 02110-1301, USA. */
252b5132
RH
22
23#ifndef _MIPS_H_
24#define _MIPS_H_
25
35d0a169
MR
26#include "bfd.h"
27
252b5132
RH
28/* These are bit masks and shift counts to use to access the various
29 fields of an instruction. To retrieve the X field of an
30 instruction, use the expression
31 (i >> OP_SH_X) & OP_MASK_X
32 To set the same field (to j), use
33 i = (i &~ (OP_MASK_X << OP_SH_X)) | (j << OP_SH_X)
34
35 Make sure you use fields that are appropriate for the instruction,
8eaec934 36 of course.
252b5132 37
8eaec934 38 The 'i' format uses OP, RS, RT and IMMEDIATE.
252b5132
RH
39
40 The 'j' format uses OP and TARGET.
41
42 The 'r' format uses OP, RS, RT, RD, SHAMT and FUNCT.
43
44 The 'b' format uses OP, RS, RT and DELTA.
45
46 The floating point 'i' format uses OP, RS, RT and IMMEDIATE.
47
48 The floating point 'r' format uses OP, FMT, FT, FS, FD and FUNCT.
49
50 A breakpoint instruction uses OP, CODE and SPEC (10 bits of the
51 breakpoint instruction are not defined; Kane says the breakpoint
52 code field in BREAK is 20 bits; yet MIPS assemblers and debuggers
53 only use ten bits). An optional two-operand form of break/sdbbp
4372b673
NC
54 allows the lower ten bits to be set too, and MIPS32 and later
55 architectures allow 20 bits to be set with a signal operand
56 (using CODE20).
252b5132 57
4372b673 58 The syscall instruction uses CODE20.
252b5132
RH
59
60 The general coprocessor instructions use COPZ. */
61
62#define OP_MASK_OP 0x3f
63#define OP_SH_OP 26
64#define OP_MASK_RS 0x1f
65#define OP_SH_RS 21
66#define OP_MASK_FR 0x1f
67#define OP_SH_FR 21
68#define OP_MASK_FMT 0x1f
69#define OP_SH_FMT 21
70#define OP_MASK_BCC 0x7
71#define OP_SH_BCC 18
72#define OP_MASK_CODE 0x3ff
73#define OP_SH_CODE 16
74#define OP_MASK_CODE2 0x3ff
75#define OP_SH_CODE2 6
76#define OP_MASK_RT 0x1f
77#define OP_SH_RT 16
78#define OP_MASK_FT 0x1f
79#define OP_SH_FT 16
80#define OP_MASK_CACHE 0x1f
81#define OP_SH_CACHE 16
82#define OP_MASK_RD 0x1f
83#define OP_SH_RD 11
84#define OP_MASK_FS 0x1f
85#define OP_SH_FS 11
86#define OP_MASK_PREFX 0x1f
87#define OP_SH_PREFX 11
88#define OP_MASK_CCC 0x7
89#define OP_SH_CCC 8
4372b673
NC
90#define OP_MASK_CODE20 0xfffff /* 20 bit syscall/breakpoint code. */
91#define OP_SH_CODE20 6
252b5132
RH
92#define OP_MASK_SHAMT 0x1f
93#define OP_SH_SHAMT 6
df58fc94
RS
94#define OP_MASK_EXTLSB OP_MASK_SHAMT
95#define OP_SH_EXTLSB OP_SH_SHAMT
96#define OP_MASK_STYPE OP_MASK_SHAMT
97#define OP_SH_STYPE OP_SH_SHAMT
252b5132
RH
98#define OP_MASK_FD 0x1f
99#define OP_SH_FD 6
100#define OP_MASK_TARGET 0x3ffffff
101#define OP_SH_TARGET 0
102#define OP_MASK_COPZ 0x1ffffff
103#define OP_SH_COPZ 0
104#define OP_MASK_IMMEDIATE 0xffff
105#define OP_SH_IMMEDIATE 0
106#define OP_MASK_DELTA 0xffff
107#define OP_SH_DELTA 0
108#define OP_MASK_FUNCT 0x3f
109#define OP_SH_FUNCT 0
110#define OP_MASK_SPEC 0x3f
111#define OP_SH_SPEC 0
4372b673
NC
112#define OP_SH_LOCC 8 /* FP condition code. */
113#define OP_SH_HICC 18 /* FP condition code. */
252b5132 114#define OP_MASK_CC 0x7
4372b673
NC
115#define OP_SH_COP1NORM 25 /* Normal COP1 encoding. */
116#define OP_MASK_COP1NORM 0x1 /* a single bit. */
117#define OP_SH_COP1SPEC 21 /* COP1 encodings. */
252b5132
RH
118#define OP_MASK_COP1SPEC 0xf
119#define OP_MASK_COP1SCLR 0x4
120#define OP_MASK_COP1CMP 0x3
121#define OP_SH_COP1CMP 4
4372b673 122#define OP_SH_FORMAT 21 /* FP short format field. */
252b5132
RH
123#define OP_MASK_FORMAT 0x7
124#define OP_SH_TRUE 16
125#define OP_MASK_TRUE 0x1
126#define OP_SH_GE 17
127#define OP_MASK_GE 0x01
128#define OP_SH_UNSIGNED 16
129#define OP_MASK_UNSIGNED 0x1
130#define OP_SH_HINT 16
131#define OP_MASK_HINT 0x1f
4372b673 132#define OP_SH_MMI 0 /* Multimedia (parallel) op. */
8eaec934 133#define OP_MASK_MMI 0x3f
252b5132
RH
134#define OP_SH_MMISUB 6
135#define OP_MASK_MMISUB 0x1f
4372b673 136#define OP_MASK_PERFREG 0x1f /* Performance monitoring. */
252b5132 137#define OP_SH_PERFREG 1
4372b673
NC
138#define OP_SH_SEL 0 /* Coprocessor select field. */
139#define OP_MASK_SEL 0x7 /* The sel field of mfcZ and mtcZ. */
140#define OP_SH_CODE19 6 /* 19 bit wait code. */
141#define OP_MASK_CODE19 0x7ffff
deec1734
CD
142#define OP_SH_ALN 21
143#define OP_MASK_ALN 0x7
144#define OP_SH_VSEL 21
145#define OP_MASK_VSEL 0x1f
9752cf1b
RS
146#define OP_MASK_VECBYTE 0x7 /* Selector field is really 4 bits,
147 but 0x8-0xf don't select bytes. */
148#define OP_SH_VECBYTE 22
149#define OP_MASK_VECALIGN 0x7 /* Vector byte-align (alni.ob) op. */
150#define OP_SH_VECALIGN 21
af7ee8bf
CD
151#define OP_MASK_INSMSB 0x1f /* "ins" MSB. */
152#define OP_SH_INSMSB 11
153#define OP_MASK_EXTMSBD 0x1f /* "ext" MSBD. */
154#define OP_SH_EXTMSBD 11
deec1734 155
93c34b9b
CF
156/* MIPS DSP ASE */
157#define OP_SH_DSPACC 11
158#define OP_MASK_DSPACC 0x3
159#define OP_SH_DSPACC_S 21
160#define OP_MASK_DSPACC_S 0x3
161#define OP_SH_DSPSFT 20
162#define OP_MASK_DSPSFT 0x3f
163#define OP_SH_DSPSFT_7 19
164#define OP_MASK_DSPSFT_7 0x7f
165#define OP_SH_SA3 21
166#define OP_MASK_SA3 0x7
167#define OP_SH_SA4 21
168#define OP_MASK_SA4 0xf
169#define OP_SH_IMM8 16
170#define OP_MASK_IMM8 0xff
171#define OP_SH_IMM10 16
172#define OP_MASK_IMM10 0x3ff
173#define OP_SH_WRDSP 11
174#define OP_MASK_WRDSP 0x3f
175#define OP_SH_RDDSP 16
176#define OP_MASK_RDDSP 0x3f
8b082fb1
TS
177#define OP_SH_BP 11
178#define OP_MASK_BP 0x3
93c34b9b 179
089b39de
CF
180/* MIPS MT ASE */
181#define OP_SH_MT_U 5
182#define OP_MASK_MT_U 0x1
183#define OP_SH_MT_H 4
184#define OP_MASK_MT_H 0x1
185#define OP_SH_MTACC_T 18
186#define OP_MASK_MTACC_T 0x3
187#define OP_SH_MTACC_D 13
188#define OP_MASK_MTACC_D 0x3
189
dec0624d
MR
190/* MIPS MCU ASE */
191#define OP_MASK_3BITPOS 0x7
192#define OP_SH_3BITPOS 12
193#define OP_MASK_OFFSET12 0xfff
194#define OP_SH_OFFSET12 0
195
640c0ccd
CD
196#define OP_OP_COP0 0x10
197#define OP_OP_COP1 0x11
198#define OP_OP_COP2 0x12
199#define OP_OP_COP3 0x13
200#define OP_OP_LWC1 0x31
201#define OP_OP_LWC2 0x32
202#define OP_OP_LWC3 0x33 /* a.k.a. pref */
203#define OP_OP_LDC1 0x35
204#define OP_OP_LDC2 0x36
205#define OP_OP_LDC3 0x37 /* a.k.a. ld */
206#define OP_OP_SWC1 0x39
207#define OP_OP_SWC2 0x3a
208#define OP_OP_SWC3 0x3b
209#define OP_OP_SDC1 0x3d
210#define OP_OP_SDC2 0x3e
211#define OP_OP_SDC3 0x3f /* a.k.a. sd */
212
b015e599
AP
213/* MIPS VIRT ASE */
214#define OP_MASK_CODE10 0x3ff
215#define OP_SH_CODE10 11
216
deec1734
CD
217/* Values in the 'VSEL' field. */
218#define MDMX_FMTSEL_IMM_QH 0x1d
219#define MDMX_FMTSEL_IMM_OB 0x1e
220#define MDMX_FMTSEL_VEC_QH 0x15
221#define MDMX_FMTSEL_VEC_OB 0x16
4372b673 222
9bcd4f99
TS
223/* UDI */
224#define OP_SH_UDI1 6
225#define OP_MASK_UDI1 0x1f
226#define OP_SH_UDI2 6
227#define OP_MASK_UDI2 0x3ff
228#define OP_SH_UDI3 6
229#define OP_MASK_UDI3 0x7fff
230#define OP_SH_UDI4 6
231#define OP_MASK_UDI4 0xfffff
232
bb35fb24
NC
233/* Octeon */
234#define OP_SH_BBITIND 16
235#define OP_MASK_BBITIND 0x1f
236#define OP_SH_CINSPOS 6
237#define OP_MASK_CINSPOS 0x1f
238#define OP_SH_CINSLM1 11
239#define OP_MASK_CINSLM1 0x1f
dd3cbb7e
NC
240#define OP_SH_SEQI 6
241#define OP_MASK_SEQI 0x3ff
bb35fb24 242
98675402
RS
243/* Loongson */
244#define OP_SH_OFFSET_A 6
245#define OP_MASK_OFFSET_A 0xff
246#define OP_SH_OFFSET_B 3
247#define OP_MASK_OFFSET_B 0xff
248#define OP_SH_OFFSET_C 6
249#define OP_MASK_OFFSET_C 0x1ff
250#define OP_SH_RZ 0
251#define OP_MASK_RZ 0x1f
252#define OP_SH_FZ 0
253#define OP_MASK_FZ 0x1f
254
df58fc94
RS
255/* Every MICROMIPSOP_X definition requires a corresponding OP_X
256 definition, and vice versa. This simplifies various parts
257 of the operand handling in GAS. The fields below only exist
258 in the microMIPS encoding, so define each one to have an empty
259 range. */
df58fc94
RS
260#define OP_MASK_TRAP 0
261#define OP_SH_TRAP 0
df58fc94
RS
262#define OP_MASK_OFFSET10 0
263#define OP_SH_OFFSET10 0
264#define OP_MASK_RS3 0
265#define OP_SH_RS3 0
266#define OP_MASK_MB 0
267#define OP_SH_MB 0
268#define OP_MASK_MC 0
269#define OP_SH_MC 0
270#define OP_MASK_MD 0
271#define OP_SH_MD 0
272#define OP_MASK_ME 0
273#define OP_SH_ME 0
274#define OP_MASK_MF 0
275#define OP_SH_MF 0
276#define OP_MASK_MG 0
277#define OP_SH_MG 0
278#define OP_MASK_MH 0
279#define OP_SH_MH 0
df58fc94
RS
280#define OP_MASK_MJ 0
281#define OP_SH_MJ 0
282#define OP_MASK_ML 0
283#define OP_SH_ML 0
284#define OP_MASK_MM 0
285#define OP_SH_MM 0
286#define OP_MASK_MN 0
287#define OP_SH_MN 0
288#define OP_MASK_MP 0
289#define OP_SH_MP 0
290#define OP_MASK_MQ 0
291#define OP_SH_MQ 0
292#define OP_MASK_IMMA 0
293#define OP_SH_IMMA 0
294#define OP_MASK_IMMB 0
295#define OP_SH_IMMB 0
296#define OP_MASK_IMMC 0
297#define OP_SH_IMMC 0
298#define OP_MASK_IMMF 0
299#define OP_SH_IMMF 0
300#define OP_MASK_IMMG 0
301#define OP_SH_IMMG 0
302#define OP_MASK_IMMH 0
303#define OP_SH_IMMH 0
304#define OP_MASK_IMMI 0
305#define OP_SH_IMMI 0
306#define OP_MASK_IMMJ 0
307#define OP_SH_IMMJ 0
308#define OP_MASK_IMML 0
309#define OP_SH_IMML 0
310#define OP_MASK_IMMM 0
311#define OP_SH_IMMM 0
312#define OP_MASK_IMMN 0
313#define OP_SH_IMMN 0
314#define OP_MASK_IMMO 0
315#define OP_SH_IMMO 0
316#define OP_MASK_IMMP 0
317#define OP_SH_IMMP 0
318#define OP_MASK_IMMQ 0
319#define OP_SH_IMMQ 0
320#define OP_MASK_IMMU 0
321#define OP_SH_IMMU 0
322#define OP_MASK_IMMW 0
323#define OP_SH_IMMW 0
324#define OP_MASK_IMMX 0
325#define OP_SH_IMMX 0
326#define OP_MASK_IMMY 0
327#define OP_SH_IMMY 0
328
7f3c4072
CM
329/* Enhanced VA Scheme */
330#define OP_SH_EVAOFFSET 7
331#define OP_MASK_EVAOFFSET 0x1ff
332
ab902481
RS
333/* Enumerates the various types of MIPS operand. */
334enum mips_operand_type {
335 /* Described by mips_int_operand. */
336 OP_INT,
337
338 /* Described by mips_mapped_int_operand. */
339 OP_MAPPED_INT,
340
341 /* Described by mips_msb_operand. */
342 OP_MSB,
343
344 /* Described by mips_reg_operand. */
345 OP_REG,
346
0f35dbc4
RS
347 /* Like OP_REG, but can be omitted if the register is the same as the
348 previous operand. */
349 OP_OPTIONAL_REG,
350
ab902481
RS
351 /* Described by mips_reg_pair_operand. */
352 OP_REG_PAIR,
353
354 /* Described by mips_pcrel_operand. */
355 OP_PCREL,
356
357 /* A performance register. The field is 5 bits in size, but the supported
358 values are much more restricted. */
359 OP_PERF_REG,
360
361 /* The final operand in a microMIPS ADDIUSP instruction. It mostly acts
362 as a normal 9-bit signed offset that is multiplied by four, but there
363 are four special cases:
364
365 -2 * 4 => -258 * 4
366 -1 * 4 => -257 * 4
367 0 * 4 => 256 * 4
368 1 * 4 => 257 * 4. */
369 OP_ADDIUSP_INT,
370
371 /* The target of a (D)CLO or (D)CLZ instruction. The operand spans two
372 5-bit register fields, both of which must be set to the destination
373 register. */
374 OP_CLO_CLZ_DEST,
375
376 /* A register list for a microMIPS LWM or SWM instruction. The operand
377 size determines whether the 16-bit or 32-bit encoding is required. */
378 OP_LWM_SWM_LIST,
379
c3c07478
RS
380 /* The register list for an emulated MIPS16 ENTRY or EXIT instruction. */
381 OP_ENTRY_EXIT_LIST,
382
383 /* The register list and frame size for a MIPS16 SAVE or RESTORE
384 instruction. */
385 OP_SAVE_RESTORE_LIST,
386
ab902481
RS
387 /* A 10-bit field VVVVVNNNNN used for octobyte and quadhalf instructions:
388
389 V Meaning
390 ----- -------
391 0EEE0 8 copies of $vN[E], OB format
392 0EE01 4 copies of $vN[E], QH format
393 10110 all 8 elements of $vN, OB format
394 10101 all 4 elements of $vN, QH format
395 11110 8 copies of immediate N, OB format
396 11101 4 copies of immediate N, QH format. */
397 OP_MDMX_IMM_REG,
398
399 /* A register operand that must match the destination register. */
400 OP_REPEAT_DEST_REG,
401
402 /* A register operand that must match the previous register. */
403 OP_REPEAT_PREV_REG,
404
405 /* $pc, which has no encoding in the architectural instruction. */
14daeee3
RS
406 OP_PC,
407
408 /* A 4-bit XYZW channel mask or 2-bit XYZW index; the size determines
409 which. */
410 OP_VU0_SUFFIX,
411
412 /* Like OP_VU0_SUFFIX, but used when the operand's value has already
413 been set. Any suffix used here must match the previous value. */
387a82f1
CF
414 OP_VU0_MATCH_SUFFIX,
415
416 /* An index selected by an integer, e.g. [1]. */
417 OP_IMM_INDEX,
418
419 /* An index selected by a register, e.g. [$2]. */
420 OP_REG_INDEX
ab902481
RS
421};
422
423/* Enumerates the types of MIPS register. */
424enum mips_reg_operand_type {
425 /* General registers $0-$31. Software names like $at can also be used. */
426 OP_REG_GP,
427
428 /* Floating-point registers $f0-$f31. */
429 OP_REG_FP,
430
431 /* Coprocessor condition code registers $cc0-$cc7. FPU condition codes
432 can also be written $fcc0-$fcc7. */
433 OP_REG_CCC,
434
435 /* FPRs used in a vector capacity. They can be written $f0-$f31
436 or $v0-$v31, although the latter form is not used for the VR5400
437 vector instructions. */
438 OP_REG_VEC,
439
440 /* DSP accumulator registers $ac0-$ac3. */
441 OP_REG_ACC,
442
443 /* Coprocessor registers $0-$31. Mnemonic names like c0_cause can
444 also be used in some contexts. */
445 OP_REG_COPRO,
446
447 /* Hardware registers $0-$31. Mnemonic names like hwr_cpunum can
448 also be used in some contexts. */
14daeee3
RS
449 OP_REG_HW,
450
451 /* Floating-point registers $vf0-$vf31. */
452 OP_REG_VF,
453
454 /* Integer registers $vi0-$vi31. */
455 OP_REG_VI,
456
457 /* R5900 VU0 registers $I, $Q, $R and $ACC. */
458 OP_REG_R5900_I,
459 OP_REG_R5900_Q,
460 OP_REG_R5900_R,
387a82f1
CF
461 OP_REG_R5900_ACC,
462
463 /* MSA registers $w0-$w31. */
464 OP_REG_MSA,
465
466 /* MSA control registers $0-$31. */
467 OP_REG_MSA_CTRL
ab902481
RS
468};
469
470/* Base class for all operands. */
471struct mips_operand
472{
473 /* The type of the operand. */
474 enum mips_operand_type type;
475
476 /* The operand occupies SIZE bits of the instruction, starting at LSB. */
477 unsigned short size;
478 unsigned short lsb;
479};
480
481/* Describes an integer operand with a regular encoding pattern. */
482struct mips_int_operand
483{
484 struct mips_operand root;
485
486 /* The low ROOT.SIZE bits of MAX_VAL encodes (MAX_VAL + BIAS) << SHIFT.
487 The cyclically previous field value encodes 1 << SHIFT less than that,
488 and so on. E.g.
489
490 - for { { T, 4, L }, 14, 0, 0 }, field values 0...14 encode themselves,
491 but 15 encodes -1.
492
493 - { { T, 8, L }, 127, 0, 2 } is a normal signed 8-bit operand that is
494 shifted left two places.
495
496 - { { T, 3, L }, 8, 0, 0 } is a normal unsigned 3-bit operand except
497 that 0 encodes 8.
498
499 - { { ... }, 0, 1, 3 } means that N encodes (N + 1) << 3. */
500 unsigned int max_val;
501 int bias;
502 unsigned int shift;
503
504 /* True if the operand should be printed as hex rather than decimal. */
505 bfd_boolean print_hex;
506};
507
508/* Uses a lookup table to describe a small integer operand. */
509struct mips_mapped_int_operand
510{
511 struct mips_operand root;
512
513 /* Maps each encoding value to the integer that it represents. */
514 const int *int_map;
515
516 /* True if the operand should be printed as hex rather than decimal. */
517 bfd_boolean print_hex;
518};
519
520/* An operand that encodes the most significant bit position of a bitfield.
521 Given a bitfield that spans bits [MSB, LSB], some operands of this type
522 encode MSB directly while others encode MSB - LSB. Each operand of this
523 type is preceded by an integer operand that specifies LSB.
524
525 The assembly form varies between instructions. For some instructions,
526 such as EXT, the operand is written as the bitfield size. For others,
527 such as EXTS, it is written in raw MSB - LSB form. */
528struct mips_msb_operand
529{
530 struct mips_operand root;
531
532 /* The assembly-level operand encoded by a field value of 0. */
533 int bias;
534
535 /* True if the operand encodes MSB directly, false if it encodes
536 MSB - LSB. */
537 bfd_boolean add_lsb;
538
539 /* The maximum value of MSB + 1. */
540 unsigned int opsize;
541};
542
543/* Describes a single register operand. */
544struct mips_reg_operand
545{
546 struct mips_operand root;
547
548 /* The type of register. */
549 enum mips_reg_operand_type reg_type;
550
551 /* If nonnull, REG_MAP[N] gives the register associated with encoding N,
552 otherwise the encoding is the same as the register number. */
553 const unsigned char *reg_map;
554};
555
556/* Describes an operand that encodes a pair of registers. */
557struct mips_reg_pair_operand
558{
559 struct mips_operand root;
560
561 /* The type of register. */
562 enum mips_reg_operand_type reg_type;
563
564 /* Encoding N represents REG1_MAP[N], REG2_MAP[N]. */
565 unsigned char *reg1_map;
566 unsigned char *reg2_map;
567};
568
569/* Describes an operand that is calculated relative to a base PC.
570 The base PC is usually the address of the following instruction,
571 but the rules for MIPS16 instructions like ADDIUPC are more complicated. */
572struct mips_pcrel_operand
573{
3ccad066
RS
574 /* Encodes the offset. */
575 struct mips_int_operand root;
ab902481 576
3ccad066
RS
577 /* The low ALIGN_LOG2 bits of the base PC are cleared to give PC',
578 which is then added to the offset encoded by ROOT. */
ab902481
RS
579 unsigned int align_log2 : 8;
580
ab902481
RS
581 /* If INCLUDE_ISA_BIT, the ISA bit of the original base PC is then
582 reinstated. This is true for jumps and branches and false for
583 PC-relative data instructions. */
584 unsigned int include_isa_bit : 1;
585
586 /* If FLIP_ISA_BIT, the ISA bit of the result is inverted.
587 This is true for JALX and false otherwise. */
588 unsigned int flip_isa_bit : 1;
589};
590
0f35dbc4
RS
591/* Return true if the assembly syntax allows OPERAND to be omitted. */
592
593static inline bfd_boolean
594mips_optional_operand_p (const struct mips_operand *operand)
595{
596 return (operand->type == OP_OPTIONAL_REG
597 || operand->type == OP_REPEAT_PREV_REG);
598}
599
ab902481
RS
600/* Return a version of INSN in which the field specified by OPERAND
601 has value UVAL. */
602
603static inline unsigned int
604mips_insert_operand (const struct mips_operand *operand, unsigned int insn,
605 unsigned int uval)
606{
607 unsigned int mask;
608
609 mask = (1 << operand->size) - 1;
610 insn &= ~(mask << operand->lsb);
611 insn |= (uval & mask) << operand->lsb;
612 return insn;
613}
614
615/* Extract OPERAND from instruction INSN. */
616
617static inline unsigned int
618mips_extract_operand (const struct mips_operand *operand, unsigned int insn)
619{
620 return (insn >> operand->lsb) & ((1 << operand->size) - 1);
621}
622
623/* UVAL is the value encoded by OPERAND. Return it in signed form. */
624
625static inline int
626mips_signed_operand (const struct mips_operand *operand, unsigned int uval)
627{
628 unsigned int sign_bit, mask;
629
630 mask = (1 << operand->size) - 1;
631 sign_bit = 1 << (operand->size - 1);
632 return ((uval + sign_bit) & mask) - sign_bit;
633}
634
635/* Return the integer that OPERAND encodes as UVAL. */
636
637static inline int
638mips_decode_int_operand (const struct mips_int_operand *operand,
639 unsigned int uval)
640{
641 uval |= (operand->max_val - uval) & -(1 << operand->root.size);
642 uval += operand->bias;
643 uval <<= operand->shift;
644 return uval;
645}
646
3ccad066
RS
647/* Return the maximum value that can be encoded by OPERAND. */
648
649static inline int
650mips_int_operand_max (const struct mips_int_operand *operand)
651{
652 return (operand->max_val + operand->bias) << operand->shift;
653}
654
655/* Return the minimum value that can be encoded by OPERAND. */
656
657static inline int
658mips_int_operand_min (const struct mips_int_operand *operand)
659{
660 unsigned int mask;
661
662 mask = (1 << operand->root.size) - 1;
663 return mips_int_operand_max (operand) - (mask << operand->shift);
664}
665
fc76e730
RS
666/* Return the register that OPERAND encodes as UVAL. */
667
668static inline int
669mips_decode_reg_operand (const struct mips_reg_operand *operand,
670 unsigned int uval)
671{
672 if (operand->reg_map)
673 uval = operand->reg_map[uval];
674 return uval;
675}
676
ab902481
RS
677/* PC-relative operand OPERAND has value UVAL and is relative to BASE_PC.
678 Return the address that it encodes. */
679
680static inline bfd_vma
681mips_decode_pcrel_operand (const struct mips_pcrel_operand *operand,
682 bfd_vma base_pc, unsigned int uval)
683{
684 bfd_vma addr;
685
686 addr = base_pc & -(1 << operand->align_log2);
3ccad066 687 addr += mips_decode_int_operand (&operand->root, uval);
ab902481
RS
688 if (operand->include_isa_bit)
689 addr |= base_pc & 1;
690 if (operand->flip_isa_bit)
691 addr ^= 1;
692 return addr;
693}
694
252b5132
RH
695/* This structure holds information for a particular instruction. */
696
697struct mips_opcode
698{
699 /* The name of the instruction. */
700 const char *name;
701 /* A string describing the arguments for this instruction. */
702 const char *args;
703 /* The basic opcode for the instruction. When assembling, this
704 opcode is modified by the arguments to produce the actual opcode
705 that is used. If pinfo is INSN_MACRO, then this is 0. */
706 unsigned long match;
707 /* If pinfo is not INSN_MACRO, then this is a bit mask for the
708 relevant portions of the opcode when disassembling. If the
709 actual opcode anded with the match field equals the opcode field,
710 then we have found the correct instruction. If pinfo is
711 INSN_MACRO, then this field is the macro identifier. */
712 unsigned long mask;
713 /* For a macro, this is INSN_MACRO. Otherwise, it is a collection
714 of bits describing the instruction, notably any relevant hazard
715 information. */
716 unsigned long pinfo;
dc9a9f39
FF
717 /* A collection of additional bits describing the instruction. */
718 unsigned long pinfo2;
252b5132
RH
719 /* A collection of bits describing the instruction sets of which this
720 instruction or macro is a member. */
721 unsigned long membership;
d301a56b
RS
722 /* A collection of bits describing the ASE of which this instruction
723 or macro is a member. */
724 unsigned long ase;
35d0a169
MR
725 /* A collection of bits describing the instruction sets of which this
726 instruction or macro is not a member. */
727 unsigned long exclusions;
252b5132
RH
728};
729
27abff54 730/* These are the characters which may appear in the args field of an
252b5132
RH
731 instruction. They appear in the order in which the fields appear
732 when the instruction is used. Commas and parentheses in the args
733 string are ignored when assembling, and written into the output
734 when disassembling.
735
736 Each of these characters corresponds to a mask field defined above.
737
18870af7 738 "1" 5 bit sync type (OP_*_STYPE)
252b5132
RH
739 "<" 5 bit shift amount (OP_*_SHAMT)
740 ">" shift amount between 32 and 63, stored after subtracting 32 (OP_*_SHAMT)
741 "a" 26 bit target address (OP_*_TARGET)
27c5c572 742 "+i" likewise, but flips bit 0
252b5132
RH
743 "b" 5 bit base register (OP_*_RS)
744 "c" 10 bit breakpoint code (OP_*_CODE)
745 "d" 5 bit destination register specifier (OP_*_RD)
746 "h" 5 bit prefx hint (OP_*_PREFX)
747 "i" 16 bit unsigned immediate (OP_*_IMMEDIATE)
748 "j" 16 bit signed immediate (OP_*_DELTA)
749 "k" 5 bit cache opcode in target register position (OP_*_CACHE)
750 "o" 16 bit signed offset (OP_*_DELTA)
751 "p" 16 bit PC relative branch target address (OP_*_DELTA)
752 "q" 10 bit extra breakpoint code (OP_*_CODE2)
753 "r" 5 bit same register used as both source and target (OP_*_RS)
754 "s" 5 bit source register specifier (OP_*_RS)
755 "t" 5 bit target register (OP_*_RT)
756 "u" 16 bit upper 16 bits of address (OP_*_IMMEDIATE)
757 "v" 5 bit same register used as both source and destination (OP_*_RS)
758 "w" 5 bit same register used as both target and destination (OP_*_RT)
4372b673
NC
759 "U" 5 bit same destination register in both OP_*_RD and OP_*_RT
760 (used by clo and clz)
252b5132 761 "C" 25 bit coprocessor function code (OP_*_COPZ)
4372b673
NC
762 "B" 20 bit syscall/breakpoint function code (OP_*_CODE20)
763 "J" 19 bit wait function code (OP_*_CODE19)
252b5132
RH
764 "x" accept and ignore register name
765 "z" must be zero register
af7ee8bf 766 "K" 5 bit Hardware Register (rdhwr instruction) (OP_*_RD)
ef0ee844 767 "+A" 5 bit ins/ext/dins/dext/dinsm/dextm position, which becomes
df58fc94
RS
768 LSB (OP_*_SHAMT; OP_*_EXTLSB or OP_*_STYPE may be used for
769 microMIPS compatibility).
071742cf 770 Enforces: 0 <= pos < 32.
ef0ee844 771 "+B" 5 bit ins/dins size, which becomes MSB (OP_*_INSMSB).
5f74bc13 772 Requires that "+A" or "+E" occur first to set position.
071742cf 773 Enforces: 0 < (pos+size) <= 32.
ef0ee844 774 "+C" 5 bit ext/dext size, which becomes MSBD (OP_*_EXTMSBD).
5f74bc13 775 Requires that "+A" or "+E" occur first to set position.
071742cf 776 Enforces: 0 < (pos+size) <= 32.
5f74bc13
CD
777 (Also used by "dext" w/ different limits, but limits for
778 that are checked by the M_DEXT macro.)
ef0ee844 779 "+E" 5 bit dinsu/dextu position, which becomes LSB-32 (OP_*_SHAMT).
5f74bc13 780 Enforces: 32 <= pos < 64.
ef0ee844 781 "+F" 5 bit "dinsm/dinsu" size, which becomes MSB-32 (OP_*_INSMSB).
5f74bc13
CD
782 Requires that "+A" or "+E" occur first to set position.
783 Enforces: 32 < (pos+size) <= 64.
784 "+G" 5 bit "dextm" size, which becomes MSBD-32 (OP_*_EXTMSBD).
785 Requires that "+A" or "+E" occur first to set position.
786 Enforces: 32 < (pos+size) <= 64.
787 "+H" 5 bit "dextu" size, which becomes MSBD (OP_*_EXTMSBD).
788 Requires that "+A" or "+E" occur first to set position.
789 Enforces: 32 < (pos+size) <= 64.
252b5132
RH
790
791 Floating point instructions:
792 "D" 5 bit destination register (OP_*_FD)
793 "M" 3 bit compare condition code (OP_*_CCC) (only used for mips4 and up)
794 "N" 3 bit branch condition code (OP_*_BCC) (only used for mips4 and up)
795 "S" 5 bit fs source 1 register (OP_*_FS)
796 "T" 5 bit ft source 2 register (OP_*_FT)
797 "R" 5 bit fr source 3 register (OP_*_FR)
798 "V" 5 bit same register used as floating source and destination (OP_*_FS)
799 "W" 5 bit same register used as floating target and destination (OP_*_FT)
800
801 Coprocessor instructions:
802 "E" 5 bit target register (OP_*_RT)
803 "G" 5 bit destination register (OP_*_RD)
8ff529d8 804 "H" 3 bit sel field for (d)mtc* and (d)mfc* (OP_*_SEL)
252b5132 805 "P" 5 bit performance-monitor register (OP_*_PERFREG)
9752cf1b
RS
806 "e" 5 bit vector register byte specifier (OP_*_VECBYTE)
807 "%" 3 bit immediate vr5400 vector alignment operand (OP_*_VECALIGN)
252b5132
RH
808
809 Macro instructions:
810 "A" General 32 bit expression
5f74bc13 811 "I" 32 bit immediate (value placed in imm_expr).
252b5132
RH
812 "F" 64 bit floating point constant in .rdata
813 "L" 64 bit floating point constant in .lit8
814 "f" 32 bit floating point constant
815 "l" 32 bit floating point constant in .lit4
816
5c324c16
RS
817 MDMX and VR5400 instruction operands (note that while these use the
818 FP register fields, the MDMX instructions accept both $fN and $vN names
819 for the registers):
820 "O" alignment offset (OP_*_ALN)
821 "Q" vector/scalar/immediate source (OP_*_VSEL and OP_*_FT)
822 "X" destination register (OP_*_FD)
823 "Y" source register (OP_*_FS)
824 "Z" source register (OP_*_FT)
deec1734 825
14daeee3
RS
826 R5900 VU0 Macromode instructions:
827 "+5" 5 bit floating point register (FD)
828 "+6" 5 bit floating point register (FS)
829 "+7" 5 bit floating point register (FT)
830 "+8" 5 bit integer register (FD)
831 "+9" 5 bit integer register (FS)
832 "+0" 5 bit integer register (FT)
833 "+K" match an existing 4-bit channel mask starting at bit 21
834 "+L" 2-bit channel index starting at bit 21
835 "+M" 2-bit channel index starting at bit 23
836 "+N" match an existing 2-bit channel index starting at bit 0
837 "+f" 15 bit immediate for VCALLMS
838 "+g" 5 bit signed immediate for VIADDI
839 "+m" $ACC register (syntax only)
840 "+q" $Q register (syntax only)
841 "+r" $R register (syntax only)
842 "+y" $I register (syntax only)
843 "#+" "++" decorator in ($reg++) sequence
844 "#-" "--" decorator in (--$reg) sequence
845
93c34b9b 846 DSP ASE usage:
8b082fb1 847 "2" 2 bit unsigned immediate for byte align (OP_*_BP)
93c34b9b
CF
848 "3" 3 bit unsigned immediate (OP_*_SA3)
849 "4" 4 bit unsigned immediate (OP_*_SA4)
850 "5" 8 bit unsigned immediate (OP_*_IMM8)
851 "6" 5 bit unsigned immediate (OP_*_RS)
852 "7" 2 bit dsp accumulator register (OP_*_DSPACC)
853 "8" 6 bit unsigned immediate (OP_*_WRDSP)
854 "9" 2 bit dsp accumulator register (OP_*_DSPACC_S)
855 "0" 6 bit signed immediate (OP_*_DSPSFT)
856 ":" 7 bit signed immediate (OP_*_DSPSFT_7)
857 "'" 6 bit unsigned immediate (OP_*_RDDSP)
858 "@" 10 bit signed immediate (OP_*_IMM10)
859
089b39de 860 MT ASE usage:
a9e24354
TS
861 "!" 1 bit usermode flag (OP_*_MT_U)
862 "$" 1 bit load high flag (OP_*_MT_H)
089b39de
CF
863 "*" 2 bit dsp/smartmips accumulator register (OP_*_MTACC_T)
864 "&" 2 bit dsp/smartmips accumulator register (OP_*_MTACC_D)
865 "g" 5 bit coprocessor 1 and 2 destination register (OP_*_RD)
866 "+t" 5 bit coprocessor 0 destination register (OP_*_RT)
089b39de 867
dec0624d
MR
868 MCU ASE usage:
869 "~" 12 bit offset (OP_*_OFFSET12)
870 "\" 3 bit position for aset and aclr (OP_*_3BITPOS)
871
b015e599
AP
872 VIRT ASE usage:
873 "+J" 10-bit hypcall code (OP_*CODE10)
874
9bcd4f99
TS
875 UDI immediates:
876 "+1" UDI immediate bits 6-10
877 "+2" UDI immediate bits 6-15
878 "+3" UDI immediate bits 6-20
879 "+4" UDI immediate bits 6-25
880
bb35fb24
NC
881 Octeon:
882 "+x" Bit index field of bbit. Enforces: 0 <= index < 32.
883 "+X" Bit index field of bbit aliasing bbit32. Matches if 32 <= index < 64,
884 otherwise skips to next candidate.
885 "+p" Position field of cins/cins32/exts/exts32. Enforces 0 <= pos < 32.
886 "+P" Position field of cins/exts aliasing cins32/exts32. Matches if
887 32 <= pos < 64, otherwise skips to next candidate.
dd3cbb7e 888 "+Q" Immediate field of seqi/snei. Enforces -512 <= imm < 512.
23e69e47
RS
889 "+s" Length-minus-one field of cins32/exts32. Requires msb position
890 of the field to be <= 31.
891 "+S" Length-minus-one field of cins/exts. Requires msb position
892 of the field to be <= 63.
bb35fb24 893
1bec78e9
RS
894 Loongson-3A:
895 "+a" 8-bit signed offset in bit 6 (OP_*_OFFSET_A)
896 "+b" 8-bit signed offset in bit 3 (OP_*_OFFSET_B)
897 "+c" 9-bit signed offset in bit 6 (OP_*_OFFSET_C)
898 "+z" 5-bit rz register (OP_*_RZ)
899 "+Z" 5-bit fz register (OP_*_FZ)
900
7f3c4072
CM
901 Enhanced VA Scheme:
902 "+j" 9-bit signed offset in bit 7 (OP_*_EVAOFFSET)
903
387a82f1
CF
904 MSA Extension:
905 "+d" 5-bit MSA register (FD)
906 "+e" 5-bit MSA register (FS)
907 "+h" 5-bit MSA register (FT)
908 "+k" 5-bit GPR at bit 6
909 "+l" 5-bit MSA control register at bit 6
910 "+n" 5-bit MSA control register at bit 11
e269fea7
AB
911 "+o" 4-bit vector element index at bit 16
912 "+u" 3-bit vector element index at bit 16
913 "+v" 2-bit vector element index at bit 16
914 "+w" 1-bit vector element index at bit 16
387a82f1
CF
915 "+T" (-512 .. 511) << 0 at bit 16
916 "+U" (-512 .. 511) << 1 at bit 16
917 "+V" (-512 .. 511) << 2 at bit 16
918 "+W" (-512 .. 511) << 3 at bit 16
919 "+~" 2 bit LSA/DLSA shift amount from 1 to 4 at bit 6
920 "+!" 3 bit unsigned bit position at bit 16
921 "+@" 4 bit unsigned bit position at bit 16
922 "+#" 6 bit unsigned bit position at bit 16
923 "+$" 5 bit unsigned immediate at bit 16
924 "+%" 5 bit signed immediate at bit 16
925 "+^" 10 bit signed immediate at bit 11
926 "+&" 0 vector element index
927 "+*" 5-bit register vector element index at bit 16
928 "+|" 8-bit mask at bit 16
929
252b5132
RH
930 Other:
931 "()" parens surrounding optional value
932 "," separates operands
af7ee8bf 933 "+" Start of extension sequence.
252b5132
RH
934
935 Characters used so far, for quick reference when adding more:
de9a3e51 936 "1234567890"
14daeee3 937 "%[]<>(),+:'@!#$*&\~"
af7ee8bf 938 "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
089b39de 939 "abcdefghijklopqrstuvwxz"
af7ee8bf
CD
940
941 Extension character sequences used so far ("+" followed by the
942 following), for quick reference when adding more:
14daeee3 943 "1234567890"
387a82f1
CF
944 "~!@#$%^&*|"
945 "ABCEFGHJKLMNPQSTUVWXZ"
946 "abcdefghijklmnopqrstuvwxyz"
252b5132
RH
947*/
948
949/* These are the bits which may be set in the pinfo field of an
950 instructions, if it is not equal to INSN_MACRO. */
951
fc76e730
RS
952/* Writes to operand number N. */
953#define INSN_WRITE_SHIFT 0
954#define INSN_WRITE_1 0x00000001
955#define INSN_WRITE_2 0x00000002
956#define INSN_WRITE_ALL 0x00000003
957/* Reads from operand number N. */
958#define INSN_READ_SHIFT 2
959#define INSN_READ_1 0x00000004
960#define INSN_READ_2 0x00000008
961#define INSN_READ_3 0x00000010
962#define INSN_READ_4 0x00000020
963#define INSN_READ_ALL 0x0000003c
252b5132 964/* Modifies general purpose register 31. */
fc76e730 965#define INSN_WRITE_GPR_31 0x00000040
252b5132 966/* Modifies coprocessor condition code. */
fc76e730 967#define INSN_WRITE_COND_CODE 0x00000080
252b5132 968/* Reads coprocessor condition code. */
fc76e730 969#define INSN_READ_COND_CODE 0x00000100
252b5132 970/* TLB operation. */
fc76e730 971#define INSN_TLB 0x00000200
252b5132 972/* Reads coprocessor register other than floating point register. */
fc76e730 973#define INSN_COP 0x00000400
67dc82bc
CM
974/* Instruction loads value from memory. */
975#define INSN_LOAD_MEMORY 0x00000800
252b5132 976/* Instruction loads value from coprocessor, requiring delay. */
fc76e730 977#define INSN_LOAD_COPROC_DELAY 0x00001000
252b5132 978/* Instruction has unconditional branch delay slot. */
fc76e730 979#define INSN_UNCOND_BRANCH_DELAY 0x00002000
252b5132 980/* Instruction has conditional branch delay slot. */
fc76e730 981#define INSN_COND_BRANCH_DELAY 0x00004000
252b5132 982/* Conditional branch likely: if branch not taken, insn nullified. */
fc76e730 983#define INSN_COND_BRANCH_LIKELY 0x00008000
252b5132 984/* Moves to coprocessor register, requiring delay. */
fc76e730 985#define INSN_COPROC_MOVE_DELAY 0x00010000
252b5132 986/* Loads coprocessor register from memory, requiring delay. */
fc76e730 987#define INSN_COPROC_MEMORY_DELAY 0x00020000
252b5132 988/* Reads the HI register. */
fc76e730 989#define INSN_READ_HI 0x00040000
252b5132 990/* Reads the LO register. */
fc76e730 991#define INSN_READ_LO 0x00080000
252b5132 992/* Modifies the HI register. */
fc76e730 993#define INSN_WRITE_HI 0x00100000
252b5132 994/* Modifies the LO register. */
fc76e730 995#define INSN_WRITE_LO 0x00200000
bcd530a7
RS
996/* Not to be placed in a branch delay slot, either architecturally
997 or for ease of handling (such as with instructions that take a trap). */
fc76e730 998#define INSN_NO_DELAY_SLOT 0x00400000
252b5132 999/* Instruction stores value into memory. */
fc76e730 1000#define INSN_STORE_MEMORY 0x00800000
252b5132 1001/* Instruction uses single precision floating point. */
fc76e730 1002#define FP_S 0x01000000
252b5132 1003/* Instruction uses double precision floating point. */
fc76e730 1004#define FP_D 0x02000000
252b5132 1005/* Instruction is part of the tx39's integer multiply family. */
fc76e730
RS
1006#define INSN_MULT 0x04000000
1007/* Reads general purpose register 24. */
1008#define INSN_READ_GPR_24 0x08000000
1009/* Writes to general purpose register 24. */
1010#define INSN_WRITE_GPR_24 0x10000000
1011/* A user-defined instruction. */
1012#define INSN_UDI 0x20000000
d0799671
AN
1013/* Instruction is actually a macro. It should be ignored by the
1014 disassembler, and requires special treatment by the assembler. */
1015#define INSN_MACRO 0xffffffff
dc9a9f39
FF
1016
1017/* These are the bits which may be set in the pinfo2 field of an
1018 instruction. */
1019
1020/* Instruction is a simple alias (I.E. "move" for daddu/addu/or) */
239cb185 1021#define INSN2_ALIAS 0x00000001
dc9a9f39 1022/* Instruction reads MDMX accumulator. */
239cb185 1023#define INSN2_READ_MDMX_ACC 0x00000002
dc9a9f39 1024/* Instruction writes MDMX accumulator. */
239cb185 1025#define INSN2_WRITE_MDMX_ACC 0x00000004
d0799671
AN
1026/* Macro uses single-precision floating-point instructions. This should
1027 only be set for macros. For instructions, FP_S in pinfo carries the
1028 same information. */
1029#define INSN2_M_FP_S 0x00000008
1030/* Macro uses double-precision floating-point instructions. This should
1031 only be set for macros. For instructions, FP_D in pinfo carries the
1032 same information. */
1033#define INSN2_M_FP_D 0x00000010
df58fc94 1034/* Instruction has a branch delay slot that requires a 16-bit instruction. */
fc76e730 1035#define INSN2_BRANCH_DELAY_16BIT 0x00000020
df58fc94 1036/* Instruction has a branch delay slot that requires a 32-bit instruction. */
fc76e730
RS
1037#define INSN2_BRANCH_DELAY_32BIT 0x00000040
1038/* Writes to the stack pointer ($29). */
1039#define INSN2_WRITE_SP 0x00000080
1040/* Reads from the stack pointer ($29). */
1041#define INSN2_READ_SP 0x00000100
df58fc94 1042/* Reads the RA ($31) register. */
fc76e730 1043#define INSN2_READ_GPR_31 0x00000200
df58fc94 1044/* Reads the program counter ($pc). */
fc76e730 1045#define INSN2_READ_PC 0x00000400
df58fc94 1046/* Is an unconditional branch insn. */
fc76e730 1047#define INSN2_UNCOND_BRANCH 0x00000800
df58fc94 1048/* Is a conditional branch insn. */
fc76e730
RS
1049#define INSN2_COND_BRANCH 0x00001000
1050/* Reads from $16. This is true of the MIPS16 0x6500 nop. */
1051#define INSN2_READ_GPR_16 0x00002000
14daeee3
RS
1052/* Has an "\.x?y?z?w?" suffix based on mips_vu0_channel_mask. */
1053#define INSN2_VU0_CHANNEL_SUFFIX 0x00004000
df58fc94 1054
e7af610e 1055/* Masks used to mark instructions to indicate which MIPS ISA level
56950294
MS
1056 they were introduced in. INSN_ISA_MASK masks an enumeration that
1057 specifies the base ISA level(s). The remainder of a 32-bit
1058 word constructed using these macros is a bitmask of the remaining
1059 INSN_* values below. */
1060
1061#define INSN_ISA_MASK 0x0000000ful
1062
1063/* We cannot start at zero due to ISA_UNKNOWN below. */
1064#define INSN_ISA1 1
1065#define INSN_ISA2 2
1066#define INSN_ISA3 3
1067#define INSN_ISA4 4
1068#define INSN_ISA5 5
1069#define INSN_ISA32 6
1070#define INSN_ISA32R2 7
1071#define INSN_ISA64 8
1072#define INSN_ISA64R2 9
1073/* Below this point the INSN_* values correspond to combinations of ISAs.
1074 They are only for use in the opcodes table to indicate membership of
1075 a combination of ISAs that cannot be expressed using the usual inclusion
1076 ordering on the above INSN_* values. */
1077#define INSN_ISA3_32 10
1078#define INSN_ISA3_32R2 11
1079#define INSN_ISA4_32 12
1080#define INSN_ISA4_32R2 13
1081#define INSN_ISA5_32R2 14
1082
1083/* Given INSN_ISA* values X and Y, where X ranges over INSN_ISA1 through
1084 INSN_ISA5_32R2 and Y ranges over INSN_ISA1 through INSN_ISA64R2,
1085 this table describes whether at least one of the ISAs described by X
1086 is/are implemented by ISA Y. (Think of Y as the ISA level supported by
1087 a particular core and X as the ISA level(s) at which a certain instruction
1088 is defined.) The ISA(s) described by X is/are implemented by Y iff
1089 (mips_isa_table[(Y & INSN_ISA_MASK) - 1] >> ((X & INSN_ISA_MASK) - 1)) & 1
1090 is non-zero. */
1091static const unsigned int mips_isa_table[] =
1092 { 0x0001, 0x0003, 0x0607, 0x1e0f, 0x3e1f, 0x0a23, 0x3e63, 0x3ebf, 0x3fff };
252b5132 1093
e6429699 1094/* Masks used for Chip specific instructions. */
432233b3 1095#define INSN_CHIP_MASK 0xc3ff0f20
e6429699
AN
1096
1097/* Cavium Networks Octeon instructions. */
1098#define INSN_OCTEON 0x00000800
dd6a37e7 1099#define INSN_OCTEONP 0x00000200
432233b3 1100#define INSN_OCTEON2 0x00000100
e6429699 1101
e407c74b
NC
1102/* MIPS R5900 instruction */
1103#define INSN_5900 0x00004000
f79e2745 1104
252b5132 1105/* MIPS R4650 instruction. */
e7af610e 1106#define INSN_4650 0x00010000
252b5132 1107/* LSI R4010 instruction. */
e7af610e
NC
1108#define INSN_4010 0x00020000
1109/* NEC VR4100 instruction. */
bf40d919 1110#define INSN_4100 0x00040000
252b5132 1111/* Toshiba R3900 instruction. */
bf40d919 1112#define INSN_3900 0x00080000
99c14723
TS
1113/* MIPS R10000 instruction. */
1114#define INSN_10000 0x00100000
2228315b
CD
1115/* Broadcom SB-1 instruction. */
1116#define INSN_SB1 0x00200000
9752cf1b
RS
1117/* NEC VR4111/VR4181 instruction. */
1118#define INSN_4111 0x00400000
1119/* NEC VR4120 instruction. */
1120#define INSN_4120 0x00800000
1121/* NEC VR5400 instruction. */
1122#define INSN_5400 0x01000000
1123/* NEC VR5500 instruction. */
1124#define INSN_5500 0x02000000
39a7806d 1125
350cc38d
MS
1126/* ST Microelectronics Loongson 2E. */
1127#define INSN_LOONGSON_2E 0x40000000
1128/* ST Microelectronics Loongson 2F. */
435b94a4 1129#define INSN_LOONGSON_2F 0x80000000
fd503541 1130/* Loongson 3A. */
435b94a4 1131#define INSN_LOONGSON_3A 0x00000400
52b6b6b9 1132/* RMI Xlr instruction */
d301a56b 1133#define INSN_XLR 0x00000020
39a7806d 1134
d301a56b
RS
1135/* DSP ASE */
1136#define ASE_DSP 0x00000001
1137#define ASE_DSP64 0x00000002
1138/* DSP R2 ASE */
1139#define ASE_DSPR2 0x00000004
7f3c4072
CM
1140/* Enhanced VA Scheme */
1141#define ASE_EVA 0x00000008
dec0624d 1142/* MCU (MicroController) ASE */
d301a56b
RS
1143#define ASE_MCU 0x00000010
1144/* MDMX ASE */
1145#define ASE_MDMX 0x00000020
1146/* MIPS-3D ASE */
1147#define ASE_MIPS3D 0x00000040
1148/* MT ASE */
1149#define ASE_MT 0x00000080
1150/* SmartMIPS ASE */
1151#define ASE_SMARTMIPS 0x00000100
1152/* Virtualization ASE */
1153#define ASE_VIRT 0x00000200
1154#define ASE_VIRT64 0x00000400
387a82f1
CF
1155/* MSA Extension */
1156#define ASE_MSA 0x00000800
1157#define ASE_MSA64 0x00001000
7d64c587
AB
1158/* eXtended Physical Address (XPA) Extension. */
1159#define ASE_XPA 0x00002000
dec0624d 1160
e7af610e
NC
1161/* MIPS ISA defines, use instead of hardcoding ISA level. */
1162
1163#define ISA_UNKNOWN 0 /* Gas internal use. */
56950294
MS
1164#define ISA_MIPS1 INSN_ISA1
1165#define ISA_MIPS2 INSN_ISA2
1166#define ISA_MIPS3 INSN_ISA3
1167#define ISA_MIPS4 INSN_ISA4
1168#define ISA_MIPS5 INSN_ISA5
af7ee8bf 1169
56950294
MS
1170#define ISA_MIPS32 INSN_ISA32
1171#define ISA_MIPS64 INSN_ISA64
367c01af 1172
56950294
MS
1173#define ISA_MIPS32R2 INSN_ISA32R2
1174#define ISA_MIPS64R2 INSN_ISA64R2
5f74bc13 1175
af7ee8bf 1176
156c2f8b
NC
1177/* CPU defines, use instead of hardcoding processor number. Keep this
1178 in sync with bfd/archures.c in order for machine selection to work. */
e7af610e 1179#define CPU_UNKNOWN 0 /* Gas internal use. */
156c2f8b
NC
1180#define CPU_R3000 3000
1181#define CPU_R3900 3900
1182#define CPU_R4000 4000
1183#define CPU_R4010 4010
1184#define CPU_VR4100 4100
1185#define CPU_R4111 4111
9752cf1b 1186#define CPU_VR4120 4120
156c2f8b
NC
1187#define CPU_R4300 4300
1188#define CPU_R4400 4400
1189#define CPU_R4600 4600
1190#define CPU_R4650 4650
1191#define CPU_R5000 5000
9752cf1b
RS
1192#define CPU_VR5400 5400
1193#define CPU_VR5500 5500
e407c74b 1194#define CPU_R5900 5900
156c2f8b 1195#define CPU_R6000 6000
5a7ea749 1196#define CPU_RM7000 7000
156c2f8b 1197#define CPU_R8000 8000
98e7aba8 1198#define CPU_RM9000 9000
156c2f8b 1199#define CPU_R10000 10000
d1cf510e 1200#define CPU_R12000 12000
3aa3176b
TS
1201#define CPU_R14000 14000
1202#define CPU_R16000 16000
156c2f8b
NC
1203#define CPU_MIPS16 16
1204#define CPU_MIPS32 32
af7ee8bf 1205#define CPU_MIPS32R2 33
84ea6cf2
NC
1206#define CPU_MIPS5 5
1207#define CPU_MIPS64 64
5f74bc13 1208#define CPU_MIPS64R2 65
c6c98b38 1209#define CPU_SB1 12310201 /* octal 'SB', 01. */
350cc38d
MS
1210#define CPU_LOONGSON_2E 3001
1211#define CPU_LOONGSON_2F 3002
fd503541 1212#define CPU_LOONGSON_3A 3003
e6429699 1213#define CPU_OCTEON 6501
dd6a37e7 1214#define CPU_OCTEONP 6601
432233b3 1215#define CPU_OCTEON2 6502
52b6b6b9 1216#define CPU_XLR 887682 /* decimal 'XLR' */
156c2f8b 1217
35d0a169
MR
1218/* Return true if the given CPU is included in INSN_* mask MASK. */
1219
1220static inline bfd_boolean
1221cpu_is_member (int cpu, unsigned int mask)
1222{
1223 switch (cpu)
1224 {
1225 case CPU_R4650:
1226 case CPU_RM7000:
1227 case CPU_RM9000:
1228 return (mask & INSN_4650) != 0;
1229
1230 case CPU_R4010:
1231 return (mask & INSN_4010) != 0;
1232
1233 case CPU_VR4100:
1234 return (mask & INSN_4100) != 0;
1235
1236 case CPU_R3900:
1237 return (mask & INSN_3900) != 0;
1238
1239 case CPU_R10000:
1240 case CPU_R12000:
1241 case CPU_R14000:
1242 case CPU_R16000:
1243 return (mask & INSN_10000) != 0;
1244
1245 case CPU_SB1:
1246 return (mask & INSN_SB1) != 0;
1247
1248 case CPU_R4111:
1249 return (mask & INSN_4111) != 0;
1250
1251 case CPU_VR4120:
1252 return (mask & INSN_4120) != 0;
1253
1254 case CPU_VR5400:
1255 return (mask & INSN_5400) != 0;
1256
1257 case CPU_VR5500:
1258 return (mask & INSN_5500) != 0;
1259
e407c74b
NC
1260 case CPU_R5900:
1261 return (mask & INSN_5900) != 0;
1262
35d0a169
MR
1263 case CPU_LOONGSON_2E:
1264 return (mask & INSN_LOONGSON_2E) != 0;
1265
1266 case CPU_LOONGSON_2F:
1267 return (mask & INSN_LOONGSON_2F) != 0;
1268
1269 case CPU_LOONGSON_3A:
1270 return (mask & INSN_LOONGSON_3A) != 0;
1271
1272 case CPU_OCTEON:
1273 return (mask & INSN_OCTEON) != 0;
1274
1275 case CPU_OCTEONP:
1276 return (mask & INSN_OCTEONP) != 0;
1277
1278 case CPU_OCTEON2:
1279 return (mask & INSN_OCTEON2) != 0;
1280
1281 case CPU_XLR:
1282 return (mask & INSN_XLR) != 0;
1283
1284 default:
1285 return FALSE;
1286 }
1287}
1288
1f25f5d3
CD
1289/* Test for membership in an ISA including chip specific ISAs. INSN
1290 is pointer to an element of the opcode table; ISA is the specified
1291 ISA/ASE bitmask to test against; and CPU is the CPU specific ISA to
35d0a169
MR
1292 test, or zero if no CPU specific ISA test is desired. Return true
1293 if instruction INSN is available to the given ISA and CPU. */
1294
1295static inline bfd_boolean
d301a56b 1296opcode_is_member (const struct mips_opcode *insn, int isa, int ase, int cpu)
35d0a169
MR
1297{
1298 if (!cpu_is_member (cpu, insn->exclusions))
1299 {
1300 /* Test for ISA level compatibility. */
1301 if ((isa & INSN_ISA_MASK) != 0
1302 && (insn->membership & INSN_ISA_MASK) != 0
1303 && ((mips_isa_table[(isa & INSN_ISA_MASK) - 1]
1304 >> ((insn->membership & INSN_ISA_MASK) - 1)) & 1) != 0)
1305 return TRUE;
1306
1307 /* Test for ASE compatibility. */
d301a56b 1308 if ((ase & insn->ase) != 0)
35d0a169
MR
1309 return TRUE;
1310
1311 /* Test for processor-specific extensions. */
1312 if (cpu_is_member (cpu, insn->membership))
1313 return TRUE;
1314 }
1315 return FALSE;
1316}
252b5132
RH
1317
1318/* This is a list of macro expanded instructions.
8eaec934 1319
e7af610e 1320 _I appended means immediate
f2ae14a1
RS
1321 _A appended means target address of a jump
1322 _AB appended means address with (possibly zero) base register
e7af610e
NC
1323 _D appended means 64 bit floating point constant
1324 _S appended means 32 bit floating point constant. */
1325
1326enum
1327{
1328 M_ABS,
dec0624d 1329 M_ACLR_AB,
e7af610e
NC
1330 M_ADD_I,
1331 M_ADDU_I,
1332 M_AND_I,
dec0624d 1333 M_ASET_AB,
8b082fb1 1334 M_BALIGN,
df58fc94
RS
1335 M_BC1FL,
1336 M_BC1TL,
1337 M_BC2FL,
1338 M_BC2TL,
e7af610e
NC
1339 M_BEQ,
1340 M_BEQ_I,
df58fc94 1341 M_BEQL,
e7af610e
NC
1342 M_BEQL_I,
1343 M_BGE,
1344 M_BGEL,
1345 M_BGE_I,
1346 M_BGEL_I,
1347 M_BGEU,
1348 M_BGEUL,
1349 M_BGEU_I,
1350 M_BGEUL_I,
df58fc94
RS
1351 M_BGEZ,
1352 M_BGEZL,
1353 M_BGEZALL,
e7af610e
NC
1354 M_BGT,
1355 M_BGTL,
1356 M_BGT_I,
1357 M_BGTL_I,
1358 M_BGTU,
1359 M_BGTUL,
1360 M_BGTU_I,
1361 M_BGTUL_I,
df58fc94
RS
1362 M_BGTZ,
1363 M_BGTZL,
e7af610e
NC
1364 M_BLE,
1365 M_BLEL,
1366 M_BLE_I,
1367 M_BLEL_I,
1368 M_BLEU,
1369 M_BLEUL,
1370 M_BLEU_I,
1371 M_BLEUL_I,
df58fc94
RS
1372 M_BLEZ,
1373 M_BLEZL,
e7af610e
NC
1374 M_BLT,
1375 M_BLTL,
1376 M_BLT_I,
1377 M_BLTL_I,
1378 M_BLTU,
1379 M_BLTUL,
1380 M_BLTU_I,
1381 M_BLTUL_I,
df58fc94
RS
1382 M_BLTZ,
1383 M_BLTZL,
1384 M_BLTZALL,
e7af610e 1385 M_BNE,
df58fc94 1386 M_BNEL,
e7af610e
NC
1387 M_BNE_I,
1388 M_BNEL_I,
d43b4baf 1389 M_CACHE_AB,
7f3c4072 1390 M_CACHEE_AB,
e7af610e
NC
1391 M_DABS,
1392 M_DADD_I,
1393 M_DADDU_I,
1394 M_DDIV_3,
1395 M_DDIV_3I,
1396 M_DDIVU_3,
1397 M_DDIVU_3I,
1398 M_DIV_3,
1399 M_DIV_3I,
1400 M_DIVU_3,
1401 M_DIVU_3I,
1402 M_DLA_AB,
1abe91b1 1403 M_DLCA_AB,
e7af610e
NC
1404 M_DLI,
1405 M_DMUL,
8eaec934 1406 M_DMUL_I,
e7af610e 1407 M_DMULO,
8eaec934 1408 M_DMULO_I,
e7af610e 1409 M_DMULOU,
8eaec934 1410 M_DMULOU_I,
e7af610e
NC
1411 M_DREM_3,
1412 M_DREM_3I,
1413 M_DREMU_3,
1414 M_DREMU_3I,
1415 M_DSUB_I,
1416 M_DSUBU_I,
1417 M_DSUBU_I_2,
1418 M_J_A,
1419 M_JAL_1,
1420 M_JAL_2,
1421 M_JAL_A,
df58fc94
RS
1422 M_JALS_1,
1423 M_JALS_2,
1424 M_JALS_A,
833794fc
MR
1425 M_JRADDIUSP,
1426 M_JRC,
e7af610e
NC
1427 M_L_DAB,
1428 M_LA_AB,
e7af610e 1429 M_LB_AB,
7f3c4072 1430 M_LBE_AB,
e7af610e 1431 M_LBU_AB,
7f3c4072 1432 M_LBUE_AB,
1abe91b1 1433 M_LCA_AB,
e7af610e
NC
1434 M_LD_AB,
1435 M_LDC1_AB,
1436 M_LDC2_AB,
c77c0862 1437 M_LQC2_AB,
e7af610e
NC
1438 M_LDC3_AB,
1439 M_LDL_AB,
df58fc94 1440 M_LDM_AB,
df58fc94 1441 M_LDP_AB,
e7af610e 1442 M_LDR_AB,
e7af610e 1443 M_LH_AB,
7f3c4072 1444 M_LHE_AB,
e7af610e 1445 M_LHU_AB,
7f3c4072 1446 M_LHUE_AB,
e7af610e
NC
1447 M_LI,
1448 M_LI_D,
1449 M_LI_DD,
1450 M_LI_S,
1451 M_LI_SS,
1452 M_LL_AB,
1453 M_LLD_AB,
7f3c4072 1454 M_LLE_AB,
e407c74b 1455 M_LQ_AB,
e7af610e 1456 M_LW_AB,
7f3c4072 1457 M_LWE_AB,
e7af610e 1458 M_LWC0_AB,
e7af610e 1459 M_LWC1_AB,
e7af610e 1460 M_LWC2_AB,
e7af610e 1461 M_LWC3_AB,
e7af610e 1462 M_LWL_AB,
7f3c4072 1463 M_LWLE_AB,
df58fc94 1464 M_LWM_AB,
df58fc94 1465 M_LWP_AB,
e7af610e 1466 M_LWR_AB,
7f3c4072 1467 M_LWRE_AB,
e7af610e 1468 M_LWU_AB,
52b6b6b9
JM
1469 M_MSGSND,
1470 M_MSGLD,
1471 M_MSGLD_T,
1472 M_MSGWAIT,
1473 M_MSGWAIT_T,
a58ec95a 1474 M_MOVE,
833794fc 1475 M_MOVEP,
e7af610e 1476 M_MUL,
8eaec934 1477 M_MUL_I,
e7af610e 1478 M_MULO,
8eaec934 1479 M_MULO_I,
e7af610e 1480 M_MULOU,
8eaec934 1481 M_MULOU_I,
e7af610e
NC
1482 M_NOR_I,
1483 M_OR_I,
3eebd5eb 1484 M_PREF_AB,
7f3c4072 1485 M_PREFE_AB,
e7af610e
NC
1486 M_REM_3,
1487 M_REM_3I,
1488 M_REMU_3,
1489 M_REMU_3I,
771c7ce4 1490 M_DROL,
e7af610e 1491 M_ROL,
771c7ce4 1492 M_DROL_I,
e7af610e 1493 M_ROL_I,
771c7ce4 1494 M_DROR,
e7af610e 1495 M_ROR,
771c7ce4 1496 M_DROR_I,
e7af610e
NC
1497 M_ROR_I,
1498 M_S_DA,
e7af610e
NC
1499 M_S_DAB,
1500 M_S_S,
dd6a37e7 1501 M_SAA_AB,
dd6a37e7 1502 M_SAAD_AB,
e7af610e
NC
1503 M_SC_AB,
1504 M_SCD_AB,
7f3c4072 1505 M_SCE_AB,
e7af610e
NC
1506 M_SD_AB,
1507 M_SDC1_AB,
1508 M_SDC2_AB,
c77c0862 1509 M_SQC2_AB,
e7af610e
NC
1510 M_SDC3_AB,
1511 M_SDL_AB,
df58fc94 1512 M_SDM_AB,
df58fc94 1513 M_SDP_AB,
e7af610e
NC
1514 M_SDR_AB,
1515 M_SEQ,
1516 M_SEQ_I,
1517 M_SGE,
1518 M_SGE_I,
1519 M_SGEU,
1520 M_SGEU_I,
1521 M_SGT,
1522 M_SGT_I,
1523 M_SGTU,
1524 M_SGTU_I,
1525 M_SLE,
1526 M_SLE_I,
1527 M_SLEU,
1528 M_SLEU_I,
1529 M_SLT_I,
1530 M_SLTU_I,
1531 M_SNE,
1532 M_SNE_I,
e7af610e 1533 M_SB_AB,
7f3c4072 1534 M_SBE_AB,
e7af610e 1535 M_SH_AB,
7f3c4072 1536 M_SHE_AB,
e407c74b 1537 M_SQ_AB,
e7af610e 1538 M_SW_AB,
7f3c4072 1539 M_SWE_AB,
e7af610e 1540 M_SWC0_AB,
e7af610e 1541 M_SWC1_AB,
e7af610e 1542 M_SWC2_AB,
e7af610e 1543 M_SWC3_AB,
e7af610e 1544 M_SWL_AB,
7f3c4072 1545 M_SWLE_AB,
df58fc94 1546 M_SWM_AB,
df58fc94 1547 M_SWP_AB,
e7af610e 1548 M_SWR_AB,
7f3c4072 1549 M_SWRE_AB,
e7af610e
NC
1550 M_SUB_I,
1551 M_SUBU_I,
1552 M_SUBU_I_2,
1553 M_TEQ_I,
1554 M_TGE_I,
1555 M_TGEU_I,
1556 M_TLT_I,
1557 M_TLTU_I,
1558 M_TNE_I,
1559 M_TRUNCWD,
1560 M_TRUNCWS,
f2ae14a1
RS
1561 M_ULD_AB,
1562 M_ULH_AB,
1563 M_ULHU_AB,
1564 M_ULW_AB,
1565 M_USH_AB,
1566 M_USW_AB,
1567 M_USD_AB,
e7af610e
NC
1568 M_XOR_I,
1569 M_COP0,
1570 M_COP1,
1571 M_COP2,
1572 M_COP3,
1573 M_NUM_MACROS
252b5132
RH
1574};
1575
1576
1577/* The order of overloaded instructions matters. Label arguments and
1578 register arguments look the same. Instructions that can have either
1579 for arguments must apear in the correct order in this table for the
1580 assembler to pick the right one. In other words, entries with
1581 immediate operands must apear after the same instruction with
1582 registers.
1583
1584 Many instructions are short hand for other instructions (i.e., The
1585 jal <register> instruction is short for jalr <register>). */
1586
14daeee3 1587extern const struct mips_operand mips_vu0_channel_mask;
ab902481 1588extern const struct mips_operand *decode_mips_operand (const char *);
252b5132
RH
1589extern const struct mips_opcode mips_builtin_opcodes[];
1590extern const int bfd_mips_num_builtin_opcodes;
1591extern struct mips_opcode *mips_opcodes;
1592extern int bfd_mips_num_opcodes;
1593#define NUMOPCODES bfd_mips_num_opcodes
1594
1595\f
1596/* The rest of this file adds definitions for the mips16 TinyRISC
1597 processor. */
1598
1599/* These are the bitmasks and shift counts used for the different
1600 fields in the instruction formats. Other than OP, no masks are
1601 provided for the fixed portions of an instruction, since they are
1602 not needed.
1603
1604 The I format uses IMM11.
1605
1606 The RI format uses RX and IMM8.
1607
1608 The RR format uses RX, and RY.
1609
1610 The RRI format uses RX, RY, and IMM5.
1611
1612 The RRR format uses RX, RY, and RZ.
1613
1614 The RRI_A format uses RX, RY, and IMM4.
1615
1616 The SHIFT format uses RX, RY, and SHAMT.
1617
1618 The I8 format uses IMM8.
1619
1620 The I8_MOVR32 format uses RY and REGR32.
1621
1622 The IR_MOV32R format uses REG32R and MOV32Z.
1623
1624 The I64 format uses IMM8.
1625
1626 The RI64 format uses RY and IMM5.
1627 */
1628
1629#define MIPS16OP_MASK_OP 0x1f
1630#define MIPS16OP_SH_OP 11
1631#define MIPS16OP_MASK_IMM11 0x7ff
1632#define MIPS16OP_SH_IMM11 0
1633#define MIPS16OP_MASK_RX 0x7
1634#define MIPS16OP_SH_RX 8
1635#define MIPS16OP_MASK_IMM8 0xff
1636#define MIPS16OP_SH_IMM8 0
1637#define MIPS16OP_MASK_RY 0x7
1638#define MIPS16OP_SH_RY 5
1639#define MIPS16OP_MASK_IMM5 0x1f
1640#define MIPS16OP_SH_IMM5 0
1641#define MIPS16OP_MASK_RZ 0x7
1642#define MIPS16OP_SH_RZ 2
1643#define MIPS16OP_MASK_IMM4 0xf
1644#define MIPS16OP_SH_IMM4 0
1645#define MIPS16OP_MASK_REGR32 0x1f
1646#define MIPS16OP_SH_REGR32 0
1647#define MIPS16OP_MASK_REG32R 0x1f
1648#define MIPS16OP_SH_REG32R 3
1649#define MIPS16OP_EXTRACT_REG32R(i) ((((i) >> 5) & 7) | ((i) & 0x18))
1650#define MIPS16OP_MASK_MOVE32Z 0x7
1651#define MIPS16OP_SH_MOVE32Z 0
1652#define MIPS16OP_MASK_IMM6 0x3f
1653#define MIPS16OP_SH_IMM6 5
1654
bb35fb24
NC
1655/* These are the characters which may appears in the args field of a MIPS16
1656 instruction. They appear in the order in which the fields appear when the
1657 instruction is used. Commas and parentheses in the args string are ignored
1658 when assembling, and written into the output when disassembling.
252b5132
RH
1659
1660 "y" 3 bit register (MIPS16OP_*_RY)
1661 "x" 3 bit register (MIPS16OP_*_RX)
1662 "z" 3 bit register (MIPS16OP_*_RZ)
1663 "Z" 3 bit register (MIPS16OP_*_MOVE32Z)
1664 "v" 3 bit same register as source and destination (MIPS16OP_*_RX)
1665 "w" 3 bit same register as source and destination (MIPS16OP_*_RY)
1666 "0" zero register ($0)
1667 "S" stack pointer ($sp or $29)
1668 "P" program counter
1669 "R" return address register ($ra or $31)
1670 "X" 5 bit MIPS register (MIPS16OP_*_REGR32)
1671 "Y" 5 bit MIPS register (MIPS16OP_*_REG32R)
1672 "6" 6 bit unsigned break code (MIPS16OP_*_IMM6)
1673 "a" 26 bit jump address
27c5c572 1674 "i" likewise, but flips bit 0
252b5132
RH
1675 "e" 11 bit extension value
1676 "l" register list for entry instruction
1677 "L" register list for exit instruction
1678
cc537e56
RS
1679 "I" an immediate value used for macros
1680
252b5132
RH
1681 The remaining codes may be extended. Except as otherwise noted,
1682 the full extended operand is a 16 bit signed value.
1683 "<" 3 bit unsigned shift count * 0 (MIPS16OP_*_RZ) (full 5 bit unsigned)
1684 ">" 3 bit unsigned shift count * 0 (MIPS16OP_*_RX) (full 5 bit unsigned)
1685 "[" 3 bit unsigned shift count * 0 (MIPS16OP_*_RZ) (full 6 bit unsigned)
1686 "]" 3 bit unsigned shift count * 0 (MIPS16OP_*_RX) (full 6 bit unsigned)
1687 "4" 4 bit signed immediate * 0 (MIPS16OP_*_IMM4) (full 15 bit signed)
1688 "5" 5 bit unsigned immediate * 0 (MIPS16OP_*_IMM5)
1689 "H" 5 bit unsigned immediate * 2 (MIPS16OP_*_IMM5)
1690 "W" 5 bit unsigned immediate * 4 (MIPS16OP_*_IMM5)
1691 "D" 5 bit unsigned immediate * 8 (MIPS16OP_*_IMM5)
1692 "j" 5 bit signed immediate * 0 (MIPS16OP_*_IMM5)
1693 "8" 8 bit unsigned immediate * 0 (MIPS16OP_*_IMM8)
1694 "V" 8 bit unsigned immediate * 4 (MIPS16OP_*_IMM8)
1695 "C" 8 bit unsigned immediate * 8 (MIPS16OP_*_IMM8)
1696 "U" 8 bit unsigned immediate * 0 (MIPS16OP_*_IMM8) (full 16 bit unsigned)
1697 "k" 8 bit signed immediate * 0 (MIPS16OP_*_IMM8)
1698 "K" 8 bit signed immediate * 8 (MIPS16OP_*_IMM8)
1699 "p" 8 bit conditional branch address (MIPS16OP_*_IMM8)
1700 "q" 11 bit branch address (MIPS16OP_*_IMM11)
1701 "A" 8 bit PC relative address * 4 (MIPS16OP_*_IMM8)
1702 "B" 5 bit PC relative address * 8 (MIPS16OP_*_IMM5)
1703 "E" 5 bit PC relative address * 4 (MIPS16OP_*_IMM5)
0499d65b
TS
1704 "m" 7 bit register list for save instruction (18 bit extended)
1705 "M" 7 bit register list for restore instruction (18 bit extended)
1706 */
1707
1708/* Save/restore encoding for the args field when all 4 registers are
1709 either saved as arguments or saved/restored as statics. */
1710#define MIPS16_ALL_ARGS 0xe
1711#define MIPS16_ALL_STATICS 0xb
252b5132 1712
252b5132
RH
1713/* The following flags have the same value for the mips16 opcode
1714 table:
7c176fa8
MR
1715
1716 INSN_ISA3
1717
252b5132
RH
1718 INSN_UNCOND_BRANCH_DELAY
1719 INSN_COND_BRANCH_DELAY
1720 INSN_COND_BRANCH_LIKELY (never used)
1721 INSN_READ_HI
1722 INSN_READ_LO
1723 INSN_WRITE_HI
1724 INSN_WRITE_LO
1725 INSN_TRAP
7c176fa8 1726 FP_D (never used)
252b5132
RH
1727 */
1728
c3c07478 1729extern const struct mips_operand *decode_mips16_operand (char, bfd_boolean);
252b5132
RH
1730extern const struct mips_opcode mips16_opcodes[];
1731extern const int bfd_mips16_num_opcodes;
1732
2309ddf2
MR
1733/* These are the bit masks and shift counts used for the different fields
1734 in the microMIPS instruction formats. No masks are provided for the
1735 fixed portions of an instruction, since they are not needed. */
df58fc94 1736
df58fc94
RS
1737#define MICROMIPSOP_MASK_IMMEDIATE 0xffff
1738#define MICROMIPSOP_SH_IMMEDIATE 0
1739#define MICROMIPSOP_MASK_DELTA 0xffff
1740#define MICROMIPSOP_SH_DELTA 0
1741#define MICROMIPSOP_MASK_CODE10 0x3ff
1742#define MICROMIPSOP_SH_CODE10 16 /* 10-bit wait code. */
1743#define MICROMIPSOP_MASK_TRAP 0xf
1744#define MICROMIPSOP_SH_TRAP 12 /* 4-bit trap code. */
1745#define MICROMIPSOP_MASK_SHAMT 0x1f
1746#define MICROMIPSOP_SH_SHAMT 11
1747#define MICROMIPSOP_MASK_TARGET 0x3ffffff
1748#define MICROMIPSOP_SH_TARGET 0
1749#define MICROMIPSOP_MASK_EXTLSB 0x1f /* "ext" LSB. */
1750#define MICROMIPSOP_SH_EXTLSB 6
1751#define MICROMIPSOP_MASK_EXTMSBD 0x1f /* "ext" MSBD. */
1752#define MICROMIPSOP_SH_EXTMSBD 11
1753#define MICROMIPSOP_MASK_INSMSB 0x1f /* "ins" MSB. */
1754#define MICROMIPSOP_SH_INSMSB 11
1755#define MICROMIPSOP_MASK_CODE 0x3ff
1756#define MICROMIPSOP_SH_CODE 16 /* 10-bit higher break code. */
1757#define MICROMIPSOP_MASK_CODE2 0x3ff
1758#define MICROMIPSOP_SH_CODE2 6 /* 10-bit lower break code. */
1759#define MICROMIPSOP_MASK_CACHE 0x1f
1760#define MICROMIPSOP_SH_CACHE 21 /* 5-bit cache op. */
1761#define MICROMIPSOP_MASK_SEL 0x7
1762#define MICROMIPSOP_SH_SEL 11
1763#define MICROMIPSOP_MASK_OFFSET12 0xfff
1764#define MICROMIPSOP_SH_OFFSET12 0
dec0624d
MR
1765#define MICROMIPSOP_MASK_3BITPOS 0x7
1766#define MICROMIPSOP_SH_3BITPOS 21
df58fc94
RS
1767#define MICROMIPSOP_MASK_STYPE 0x1f
1768#define MICROMIPSOP_SH_STYPE 16
1769#define MICROMIPSOP_MASK_OFFSET10 0x3ff
1770#define MICROMIPSOP_SH_OFFSET10 6
1771#define MICROMIPSOP_MASK_RS 0x1f
1772#define MICROMIPSOP_SH_RS 16
1773#define MICROMIPSOP_MASK_RT 0x1f
1774#define MICROMIPSOP_SH_RT 21
1775#define MICROMIPSOP_MASK_RD 0x1f
1776#define MICROMIPSOP_SH_RD 11
1777#define MICROMIPSOP_MASK_FS 0x1f
1778#define MICROMIPSOP_SH_FS 16
1779#define MICROMIPSOP_MASK_FT 0x1f
1780#define MICROMIPSOP_SH_FT 21
1781#define MICROMIPSOP_MASK_FD 0x1f
1782#define MICROMIPSOP_SH_FD 11
1783#define MICROMIPSOP_MASK_FR 0x1f
1784#define MICROMIPSOP_SH_FR 6
1785#define MICROMIPSOP_MASK_RS3 0x1f
1786#define MICROMIPSOP_SH_RS3 6
1787#define MICROMIPSOP_MASK_PREFX 0x1f
1788#define MICROMIPSOP_SH_PREFX 11
1789#define MICROMIPSOP_MASK_BCC 0x7
1790#define MICROMIPSOP_SH_BCC 18
1791#define MICROMIPSOP_MASK_CCC 0x7
1792#define MICROMIPSOP_SH_CCC 13
1793#define MICROMIPSOP_MASK_COPZ 0x7fffff
1794#define MICROMIPSOP_SH_COPZ 3
1795
1796#define MICROMIPSOP_MASK_MB 0x7
1797#define MICROMIPSOP_SH_MB 23
1798#define MICROMIPSOP_MASK_MC 0x7
1799#define MICROMIPSOP_SH_MC 4
1800#define MICROMIPSOP_MASK_MD 0x7
1801#define MICROMIPSOP_SH_MD 7
1802#define MICROMIPSOP_MASK_ME 0x7
1803#define MICROMIPSOP_SH_ME 1
1804#define MICROMIPSOP_MASK_MF 0x7
1805#define MICROMIPSOP_SH_MF 3
1806#define MICROMIPSOP_MASK_MG 0x7
1807#define MICROMIPSOP_SH_MG 0
1808#define MICROMIPSOP_MASK_MH 0x7
1809#define MICROMIPSOP_SH_MH 7
df58fc94
RS
1810#define MICROMIPSOP_MASK_MJ 0x1f
1811#define MICROMIPSOP_SH_MJ 0
1812#define MICROMIPSOP_MASK_ML 0x7
1813#define MICROMIPSOP_SH_ML 4
1814#define MICROMIPSOP_MASK_MM 0x7
1815#define MICROMIPSOP_SH_MM 1
1816#define MICROMIPSOP_MASK_MN 0x7
1817#define MICROMIPSOP_SH_MN 4
1818#define MICROMIPSOP_MASK_MP 0x1f
1819#define MICROMIPSOP_SH_MP 5
1820#define MICROMIPSOP_MASK_MQ 0x7
1821#define MICROMIPSOP_SH_MQ 7
1822
1823#define MICROMIPSOP_MASK_IMMA 0x7f
1824#define MICROMIPSOP_SH_IMMA 0
1825#define MICROMIPSOP_MASK_IMMB 0x7
1826#define MICROMIPSOP_SH_IMMB 1
1827#define MICROMIPSOP_MASK_IMMC 0xf
1828#define MICROMIPSOP_SH_IMMC 0
1829#define MICROMIPSOP_MASK_IMMD 0x3ff
1830#define MICROMIPSOP_SH_IMMD 0
1831#define MICROMIPSOP_MASK_IMME 0x7f
1832#define MICROMIPSOP_SH_IMME 0
1833#define MICROMIPSOP_MASK_IMMF 0xf
1834#define MICROMIPSOP_SH_IMMF 0
1835#define MICROMIPSOP_MASK_IMMG 0xf
1836#define MICROMIPSOP_SH_IMMG 0
1837#define MICROMIPSOP_MASK_IMMH 0xf
1838#define MICROMIPSOP_SH_IMMH 0
1839#define MICROMIPSOP_MASK_IMMI 0x7f
1840#define MICROMIPSOP_SH_IMMI 0
1841#define MICROMIPSOP_MASK_IMMJ 0xf
1842#define MICROMIPSOP_SH_IMMJ 0
1843#define MICROMIPSOP_MASK_IMML 0xf
1844#define MICROMIPSOP_SH_IMML 0
1845#define MICROMIPSOP_MASK_IMMM 0x7
1846#define MICROMIPSOP_SH_IMMM 1
1847#define MICROMIPSOP_MASK_IMMN 0x3
1848#define MICROMIPSOP_SH_IMMN 4
1849#define MICROMIPSOP_MASK_IMMO 0xf
1850#define MICROMIPSOP_SH_IMMO 0
1851#define MICROMIPSOP_MASK_IMMP 0x1f
1852#define MICROMIPSOP_SH_IMMP 0
1853#define MICROMIPSOP_MASK_IMMQ 0x7fffff
1854#define MICROMIPSOP_SH_IMMQ 0
1855#define MICROMIPSOP_MASK_IMMU 0x1f
1856#define MICROMIPSOP_SH_IMMU 0
1857#define MICROMIPSOP_MASK_IMMW 0x3f
1858#define MICROMIPSOP_SH_IMMW 1
1859#define MICROMIPSOP_MASK_IMMX 0xf
1860#define MICROMIPSOP_SH_IMMX 1
1861#define MICROMIPSOP_MASK_IMMY 0x1ff
1862#define MICROMIPSOP_SH_IMMY 1
1863
03f66e8a
MR
1864/* MIPS DSP ASE */
1865#define MICROMIPSOP_MASK_DSPACC 0x3
1866#define MICROMIPSOP_SH_DSPACC 14
1867#define MICROMIPSOP_MASK_DSPSFT 0x3f
1868#define MICROMIPSOP_SH_DSPSFT 16
1869#define MICROMIPSOP_MASK_SA3 0x7
1870#define MICROMIPSOP_SH_SA3 13
1871#define MICROMIPSOP_MASK_SA4 0xf
1872#define MICROMIPSOP_SH_SA4 12
1873#define MICROMIPSOP_MASK_IMM8 0xff
1874#define MICROMIPSOP_SH_IMM8 13
1875#define MICROMIPSOP_MASK_IMM10 0x3ff
1876#define MICROMIPSOP_SH_IMM10 16
1877#define MICROMIPSOP_MASK_WRDSP 0x3f
1878#define MICROMIPSOP_SH_WRDSP 14
1879#define MICROMIPSOP_MASK_BP 0x3
1880#define MICROMIPSOP_SH_BP 14
1881
df58fc94
RS
1882/* Placeholders for fields that only exist in the traditional 32-bit
1883 instruction encoding; see the comment above for details. */
1884#define MICROMIPSOP_MASK_CODE20 0
1885#define MICROMIPSOP_SH_CODE20 0
1886#define MICROMIPSOP_MASK_PERFREG 0
1887#define MICROMIPSOP_SH_PERFREG 0
1888#define MICROMIPSOP_MASK_CODE19 0
1889#define MICROMIPSOP_SH_CODE19 0
1890#define MICROMIPSOP_MASK_ALN 0
1891#define MICROMIPSOP_SH_ALN 0
1892#define MICROMIPSOP_MASK_VECBYTE 0
1893#define MICROMIPSOP_SH_VECBYTE 0
1894#define MICROMIPSOP_MASK_VECALIGN 0
1895#define MICROMIPSOP_SH_VECALIGN 0
df58fc94
RS
1896#define MICROMIPSOP_MASK_DSPACC_S 0
1897#define MICROMIPSOP_SH_DSPACC_S 0
df58fc94
RS
1898#define MICROMIPSOP_MASK_DSPSFT_7 0
1899#define MICROMIPSOP_SH_DSPSFT_7 0
df58fc94
RS
1900#define MICROMIPSOP_MASK_RDDSP 0
1901#define MICROMIPSOP_SH_RDDSP 0
df58fc94
RS
1902#define MICROMIPSOP_MASK_MT_U 0
1903#define MICROMIPSOP_SH_MT_U 0
1904#define MICROMIPSOP_MASK_MT_H 0
1905#define MICROMIPSOP_SH_MT_H 0
1906#define MICROMIPSOP_MASK_MTACC_T 0
1907#define MICROMIPSOP_SH_MTACC_T 0
1908#define MICROMIPSOP_MASK_MTACC_D 0
1909#define MICROMIPSOP_SH_MTACC_D 0
1910#define MICROMIPSOP_MASK_BBITIND 0
1911#define MICROMIPSOP_SH_BBITIND 0
1912#define MICROMIPSOP_MASK_CINSPOS 0
1913#define MICROMIPSOP_SH_CINSPOS 0
1914#define MICROMIPSOP_MASK_CINSLM1 0
1915#define MICROMIPSOP_SH_CINSLM1 0
1916#define MICROMIPSOP_MASK_SEQI 0
1917#define MICROMIPSOP_SH_SEQI 0
1918#define MICROMIPSOP_SH_OFFSET_A 0
1919#define MICROMIPSOP_MASK_OFFSET_A 0
1920#define MICROMIPSOP_SH_OFFSET_B 0
1921#define MICROMIPSOP_MASK_OFFSET_B 0
1922#define MICROMIPSOP_SH_OFFSET_C 0
1923#define MICROMIPSOP_MASK_OFFSET_C 0
1924#define MICROMIPSOP_SH_RZ 0
1925#define MICROMIPSOP_MASK_RZ 0
1926#define MICROMIPSOP_SH_FZ 0
1927#define MICROMIPSOP_MASK_FZ 0
1928
7f3c4072
CM
1929/* microMIPS Enhanced VA Scheme */
1930#define MICROMIPSOP_SH_EVAOFFSET 0
1931#define MICROMIPSOP_MASK_EVAOFFSET 0x1ff
1932
df58fc94
RS
1933/* These are the characters which may appears in the args field of a microMIPS
1934 instruction. They appear in the order in which the fields appear
1935 when the instruction is used. Commas and parentheses in the args
1936 string are ignored when assembling, and written into the output
1937 when disassembling.
1938
1939 The followings are for 16-bit microMIPS instructions.
1940
1941 "ma" must be $28
1942 "mc" 3-bit MIPS registers 2-7, 16, 17 (MICROMIPSOP_*_MC) at bit 4
1943 The same register used as both source and target.
1944 "md" 3-bit MIPS registers 2-7, 16, 17 (MICROMIPSOP_*_MD) at bit 7
1945 "me" 3-bit MIPS registers 2-7, 16, 17 (MICROMIPSOP_*_ME) at bit 1
1946 The same register used as both source and target.
1947 "mf" 3-bit MIPS registers 2-7, 16, 17 (MICROMIPSOP_*_MF) at bit 3
1948 "mg" 3-bit MIPS registers 2-7, 16, 17 (MICROMIPSOP_*_MG) at bit 0
e76ff5ab 1949 "mh" 3-bit MIPS register pair (MICROMIPSOP_*_MH) at bit 7
df58fc94
RS
1950 "mj" 5-bit MIPS registers (MICROMIPSOP_*_MJ) at bit 0
1951 "ml" 3-bit MIPS registers 2-7, 16, 17 (MICROMIPSOP_*_ML) at bit 4
1952 "mm" 3-bit MIPS registers 0, 2, 3, 16-20 (MICROMIPSOP_*_MM) at bit 1
1953 "mn" 3-bit MIPS registers 0, 2, 3, 16-20 (MICROMIPSOP_*_MN) at bit 4
1954 "mp" 5-bit MIPS registers (MICROMIPSOP_*_MP) at bit 5
1955 "mq" 3-bit MIPS registers 0, 2-7, 17 (MICROMIPSOP_*_MQ) at bit 7
1956 "mr" must be program counter
1957 "ms" must be $29
1958 "mt" must be the same as the previous register
1959 "mx" must be the same as the destination register
1960 "my" must be $31
1961 "mz" must be $0
1962
1963 "mA" 7-bit immediate (-64 .. 63) << 2 (MICROMIPSOP_*_IMMA)
1964 "mB" 3-bit immediate (-1, 1, 4, 8, 12, 16, 20, 24) (MICROMIPSOP_*_IMMB)
1965 "mC" 4-bit immediate (1, 2, 3, 4, 7, 8, 15, 16, 31, 32, 63, 64, 128, 255,
1966 32768, 65535) (MICROMIPSOP_*_IMMC)
1967 "mD" 10-bit branch address (-512 .. 511) << 1 (MICROMIPSOP_*_IMMD)
1968 "mE" 7-bit branch address (-64 .. 63) << 1 (MICROMIPSOP_*_IMME)
1969 "mF" 4-bit immediate (0 .. 15) (MICROMIPSOP_*_IMMF)
1970 "mG" 4-bit immediate (-1 .. 14) (MICROMIPSOP_*_IMMG)
1971 "mH" 4-bit immediate (0 .. 15) << 1 (MICROMIPSOP_*_IMMH)
1972 "mI" 7-bit immediate (-1 .. 126) (MICROMIPSOP_*_IMMI)
1973 "mJ" 4-bit immediate (0 .. 15) << 2 (MICROMIPSOP_*_IMMJ)
1974 "mL" 4-bit immediate (0 .. 15) (MICROMIPSOP_*_IMML)
1975 "mM" 3-bit immediate (1 .. 8) (MICROMIPSOP_*_IMMM)
1976 "mN" 2-bit immediate (0 .. 3) for register list (MICROMIPSOP_*_IMMN)
1977 "mO" 4-bit immediate (0 .. 15) (MICROMIPSOP_*_IMML)
1978 "mP" 5-bit immediate (0 .. 31) << 2 (MICROMIPSOP_*_IMMP)
1979 "mU" 5-bit immediate (0 .. 31) << 2 (MICROMIPSOP_*_IMMU)
1980 "mW" 6-bit immediate (0 .. 63) << 2 (MICROMIPSOP_*_IMMW)
1981 "mX" 4-bit immediate (-8 .. 7) (MICROMIPSOP_*_IMMX)
1982 "mY" 9-bit immediate (-258 .. -3, 2 .. 257) << 2 (MICROMIPSOP_*_IMMY)
1983 "mZ" must be zero
1984
1985 In most cases 32-bit microMIPS instructions use the same characters
1986 as MIPS (with ADDIUPC being a notable exception, but there are some
1987 others too).
1988
1989 "." 10-bit signed offset/number (MICROMIPSOP_*_OFFSET10)
18870af7 1990 "1" 5-bit sync type (MICROMIPSOP_*_STYPE)
df58fc94
RS
1991 "<" 5-bit shift amount (MICROMIPSOP_*_SHAMT)
1992 ">" shift amount between 32 and 63, stored after subtracting 32
1993 (MICROMIPSOP_*_SHAMT)
dec0624d 1994 "\" 3-bit position for ASET and ACLR (MICROMIPSOP_*_3BITPOS)
df58fc94
RS
1995 "|" 4-bit trap code (MICROMIPSOP_*_TRAP)
1996 "~" 12-bit signed offset (MICROMIPSOP_*_OFFSET12)
1997 "a" 26-bit target address (MICROMIPSOP_*_TARGET)
27c5c572 1998 "+i" likewise, but flips bit 0
df58fc94
RS
1999 "b" 5-bit base register (MICROMIPSOP_*_RS)
2000 "c" 10-bit higher breakpoint code (MICROMIPSOP_*_CODE)
2001 "d" 5-bit destination register specifier (MICROMIPSOP_*_RD)
2002 "h" 5-bit PREFX hint (MICROMIPSOP_*_PREFX)
26f85d7a 2003 "i" 16-bit unsigned immediate (MICROMIPSOP_*_IMMEDIATE)
df58fc94
RS
2004 "j" 16-bit signed immediate (MICROMIPSOP_*_DELTA)
2005 "k" 5-bit cache opcode in target register position (MICROMIPSOP_*_CACHE)
2006 "n" register list for 32-bit LWM/SWM instruction (MICROMIPSOP_*_RT)
2007 "o" 16-bit signed offset (MICROMIPSOP_*_DELTA)
2008 "p" 16-bit PC-relative branch target address (MICROMIPSOP_*_DELTA)
2009 "q" 10-bit lower breakpoint code (MICROMIPSOP_*_CODE2)
2010 "r" 5-bit same register used as both source and target (MICROMIPSOP_*_RS)
2011 "s" 5-bit source register specifier (MICROMIPSOP_*_RS)
2012 "t" 5-bit target register (MICROMIPSOP_*_RT)
2013 "u" 16-bit upper 16 bits of address (MICROMIPSOP_*_IMMEDIATE)
2014 "v" 5-bit same register used as both source and destination
2015 (MICROMIPSOP_*_RS)
2016 "w" 5-bit same register used as both target and destination
2017 (MICROMIPSOP_*_RT)
2018 "y" 5-bit source 3 register for ALNV.PS (MICROMIPSOP_*_RS3)
2019 "z" must be zero register
2020 "C" 23-bit coprocessor function code (MICROMIPSOP_*_COPZ)
9d7b4c23 2021 "B" 10-bit syscall/wait function code (MICROMIPSOP_*_CODE10)
df58fc94
RS
2022 "K" 5-bit Hardware Register (RDHWR instruction) (MICROMIPSOP_*_RS)
2023
2024 "+A" 5-bit INS/EXT/DINS/DEXT/DINSM/DEXTM position, which becomes
2025 LSB (MICROMIPSOP_*_EXTLSB).
2026 Enforces: 0 <= pos < 32.
2027 "+B" 5-bit INS/DINS size, which becomes MSB (MICROMIPSOP_*_INSMSB).
2028 Requires that "+A" or "+E" occur first to set position.
2029 Enforces: 0 < (pos+size) <= 32.
2030 "+C" 5-bit EXT/DEXT size, which becomes MSBD (MICROMIPSOP_*_EXTMSBD).
2031 Requires that "+A" or "+E" occur first to set position.
2032 Enforces: 0 < (pos+size) <= 32.
2033 (Also used by DEXT w/ different limits, but limits for
2034 that are checked by the M_DEXT macro.)
2035 "+E" 5-bit DINSU/DEXTU position, which becomes LSB-32 (MICROMIPSOP_*_EXTLSB).
2036 Enforces: 32 <= pos < 64.
2037 "+F" 5-bit DINSM/DINSU size, which becomes MSB-32 (MICROMIPSOP_*_INSMSB).
2038 Requires that "+A" or "+E" occur first to set position.
2039 Enforces: 32 < (pos+size) <= 64.
2040 "+G" 5-bit DEXTM size, which becomes MSBD-32 (MICROMIPSOP_*_EXTMSBD).
2041 Requires that "+A" or "+E" occur first to set position.
2042 Enforces: 32 < (pos+size) <= 64.
2043 "+H" 5-bit DEXTU size, which becomes MSBD (MICROMIPSOP_*_EXTMSBD).
2044 Requires that "+A" or "+E" occur first to set position.
2045 Enforces: 32 < (pos+size) <= 64.
2046
2047 PC-relative addition (ADDIUPC) instruction:
2048 "mQ" 23-bit offset (-4194304 .. 4194303) << 2 (MICROMIPSOP_*_IMMQ)
2049 "mb" 3-bit MIPS registers 2-7, 16, 17 (MICROMIPSOP_*_MB) at bit 23
2050
2051 Floating point instructions:
2052 "D" 5-bit destination register (MICROMIPSOP_*_FD)
2053 "M" 3-bit compare condition code (MICROMIPSOP_*_CCC)
2054 "N" 3-bit branch condition code (MICROMIPSOP_*_BCC)
2055 "R" 5-bit fr source 3 register (MICROMIPSOP_*_FR)
2056 "S" 5-bit fs source 1 register (MICROMIPSOP_*_FS)
2057 "T" 5-bit ft source 2 register (MICROMIPSOP_*_FT)
2058 "V" 5-bit same register used as floating source and destination or target
2059 (MICROMIPSOP_*_FS)
2060
2061 Coprocessor instructions:
2062 "E" 5-bit target register (MICROMIPSOP_*_RT)
18870af7 2063 "G" 5-bit source register (MICROMIPSOP_*_RS)
df58fc94 2064 "H" 3-bit sel field for (D)MTC* and (D)MFC* (MICROMIPSOP_*_SEL)
df58fc94
RS
2065
2066 Macro instructions:
2067 "A" general 32 bit expression
2068 "I" 32-bit immediate (value placed in imm_expr).
df58fc94
RS
2069 "F" 64-bit floating point constant in .rdata
2070 "L" 64-bit floating point constant in .lit8
2071 "f" 32-bit floating point constant
2072 "l" 32-bit floating point constant in .lit4
2073
03f66e8a
MR
2074 DSP ASE usage:
2075 "2" 2-bit unsigned immediate for byte align (MICROMIPSOP_*_BP)
2076 "3" 3-bit unsigned immediate (MICROMIPSOP_*_SA3)
2077 "4" 4-bit unsigned immediate (MICROMIPSOP_*_SA4)
2078 "5" 8-bit unsigned immediate (MICROMIPSOP_*_IMM8)
2079 "6" 5-bit unsigned immediate (MICROMIPSOP_*_RS)
2080 "7" 2-bit DSP accumulator register (MICROMIPSOP_*_DSPACC)
2081 "8" 6-bit unsigned immediate (MICROMIPSOP_*_WRDSP)
2082 "0" 6-bit signed immediate (MICROMIPSOP_*_DSPSFT)
2083 "@" 10-bit signed immediate (MICROMIPSOP_*_IMM10)
2084 "^" 5-bit unsigned immediate (MICROMIPSOP_*_RD)
2085
7f3c4072
CM
2086 microMIPS Enhanced VA Scheme:
2087 "+j" 9-bit signed offset in bit 0 (OP_*_EVAOFFSET)
2088
387a82f1
CF
2089 MSA Extension:
2090 "+d" 5-bit MSA register (FD)
2091 "+e" 5-bit MSA register (FS)
2092 "+h" 5-bit MSA register (FT)
2093 "+k" 5-bit GPR at bit 6
2094 "+l" 5-bit MSA control register at bit 6
2095 "+n" 5-bit MSA control register at bit 11
e269fea7
AB
2096 "+o" 4-bit vector element index at bit 16
2097 "+u" 3-bit vector element index at bit 16
2098 "+v" 2-bit vector element index at bit 16
2099 "+w" 1-bit vector element index at bit 16
387a82f1
CF
2100 "+x" 5-bit shift amount at bit 16
2101 "+T" (-512 .. 511) << 0 at bit 16
2102 "+U" (-512 .. 511) << 1 at bit 16
2103 "+V" (-512 .. 511) << 2 at bit 16
2104 "+W" (-512 .. 511) << 3 at bit 16
2105 "+~" 2 bit LSA/DLSA shift amount from 1 to 4 at bit 6
2106 "+!" 3 bit unsigned bit position at bit 16
2107 "+@" 4 bit unsigned bit position at bit 16
2108 "+#" 6 bit unsigned bit position at bit 16
2109 "+$" 5 bit unsigned immediate at bit 16
2110 "+%" 5 bit signed immediate at bit 16
2111 "+^" 10 bit signed immediate at bit 11
2112 "+&" 0 vector element index
2113 "+*" 5-bit register vector element index at bit 16
2114 "+|" 8-bit mask at bit 16
2115
df58fc94
RS
2116 Other:
2117 "()" parens surrounding optional value
2118 "," separates operands
2119 "+" start of extension sequence
2120 "m" start of microMIPS extension sequence
2121
2122 Characters used so far, for quick reference when adding more:
03f66e8a
MR
2123 "12345678 0"
2124 "<>(),+.@\^|~"
df58fc94
RS
2125 "ABCDEFGHI KLMN RST V "
2126 "abcd f hijklmnopqrstuvw yz"
2127
2128 Extension character sequences used so far ("+" followed by the
2129 following), for quick reference when adding more:
df58fc94 2130 ""
387a82f1
CF
2131 "~!@#$%^&*|"
2132 "ABCEFGHTUVW"
2133 "dehijklnouvwx"
df58fc94
RS
2134
2135 Extension character sequences used so far ("m" followed by the
2136 following), for quick reference when adding more:
2137 ""
2138 ""
2139 " BCDEFGHIJ LMNOPQ U WXYZ"
2140 " bcdefghij lmn pq st xyz"
2141*/
2142
ab902481 2143extern const struct mips_operand *decode_micromips_operand (const char *);
df58fc94
RS
2144extern const struct mips_opcode micromips_opcodes[];
2145extern const int bfd_micromips_num_opcodes;
2146
c67a084a
NC
2147/* A NOP insn impemented as "or at,at,zero".
2148 Used to implement -mfix-loongson2f. */
2149#define LOONGSON2F_NOP_INSN 0x00200825
2150
252b5132 2151#endif /* _MIPS_H_ */