[deliverable/binutils-gdb.git] / include / xtensa-isa-internal.h

/* Internal definitions for configurable Xtensa ISA support.
   Copyright 2003, 2004, 2005, 2008, 2010 Free Software Foundation, Inc.

   This file is part of BFD, the Binary File Descriptor library.

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 3 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301,
   USA.  */

#ifndef XTENSA_ISA_INTERNAL_H
#define XTENSA_ISA_INTERNAL_H

/* Flags.  */

#define XTENSA_OPERAND_IS_REGISTER	0x00000001
#define XTENSA_OPERAND_IS_PCRELATIVE	0x00000002
#define XTENSA_OPERAND_IS_INVISIBLE	0x00000004
#define XTENSA_OPERAND_IS_UNKNOWN	0x00000008

#define XTENSA_OPCODE_IS_BRANCH		0x00000001
#define XTENSA_OPCODE_IS_JUMP		0x00000002
#define XTENSA_OPCODE_IS_LOOP		0x00000004
#define XTENSA_OPCODE_IS_CALL		0x00000008

#define XTENSA_STATE_IS_EXPORTED	0x00000001
#define XTENSA_STATE_IS_SHARED_OR	0x00000002

#define XTENSA_INTERFACE_HAS_SIDE_EFFECT 0x00000001

/* Function pointer typedefs */
typedef void (*xtensa_format_encode_fn) (xtensa_insnbuf);
typedef void (*xtensa_get_slot_fn) (const xtensa_insnbuf, xtensa_insnbuf);
typedef void (*xtensa_set_slot_fn) (xtensa_insnbuf, const xtensa_insnbuf);
typedef int (*xtensa_opcode_decode_fn) (const xtensa_insnbuf);
typedef uint32 (*xtensa_get_field_fn) (const xtensa_insnbuf);
typedef void (*xtensa_set_field_fn) (xtensa_insnbuf, uint32);
typedef int (*xtensa_immed_decode_fn) (uint32 *);
typedef int (*xtensa_immed_encode_fn) (uint32 *);
typedef int (*xtensa_do_reloc_fn) (uint32 *, uint32);
typedef int (*xtensa_undo_reloc_fn) (uint32 *, uint32);
typedef void (*xtensa_opcode_encode_fn) (xtensa_insnbuf);
typedef int (*xtensa_format_decode_fn) (const xtensa_insnbuf);
typedef int (*xtensa_length_decode_fn) (const unsigned char *);

typedef struct xtensa_format_internal_struct
{
  const char *name;			/* Instruction format name.  */
  int length;				/* Instruction length in bytes.  */
  xtensa_format_encode_fn encode_fn;
  int num_slots;
  int *slot_id;				/* Array[num_slots] of slot IDs.  */
} xtensa_format_internal;

typedef struct xtensa_slot_internal_struct
{
  const char *name;			/* Not necessarily unique.  */
  const char *format;
  int position;
  xtensa_get_slot_fn get_fn;
  xtensa_set_slot_fn set_fn;
  xtensa_get_field_fn *get_field_fns;	/* Array[field_id].  */
  xtensa_set_field_fn *set_field_fns;	/* Array[field_id].  */
  xtensa_opcode_decode_fn opcode_decode_fn;
  const char *nop_name;
} xtensa_slot_internal;

typedef struct xtensa_operand_internal_struct
{
  const char *name;
  int field_id;
  xtensa_regfile regfile;		/* Register file.  */
  int num_regs;				/* Usually 1; 2 for reg pairs, etc.  */
  uint32 flags;				/* See XTENSA_OPERAND_* flags.  */
  xtensa_immed_encode_fn encode;	/* Encode the operand value.  */
  xtensa_immed_decode_fn decode;	/* Decode the value from the field.  */
  xtensa_do_reloc_fn do_reloc;		/* Perform a PC-relative reloc.  */
  xtensa_undo_reloc_fn undo_reloc;	/* Undo a PC-relative relocation.  */
} xtensa_operand_internal;

typedef struct xtensa_arg_internal_struct
{
  union {
    int operand_id;			/* For normal operands.  */
    xtensa_state state;			/* For stateOperands.  */
  } u;
  char inout;				/* Direction: 'i', 'o', or 'm'.  */
} xtensa_arg_internal;

typedef struct xtensa_iclass_internal_struct
{
  int num_operands;			/* Size of "operands" array.  */
  xtensa_arg_internal *operands;	/* Array[num_operands].  */

  int num_stateOperands;		/* Size of "stateOperands" array.  */
  xtensa_arg_internal *stateOperands;	/* Array[num_stateOperands].  */

  int num_interfaceOperands;		/* Size of "interfaceOperands".  */
  xtensa_interface *interfaceOperands;	/* Array[num_interfaceOperands].  */
} xtensa_iclass_internal;

typedef struct xtensa_opcode_internal_struct
{
  const char *name;			/* Opcode mnemonic.  */
  int iclass_id;			/* Iclass for this opcode.  */
  uint32 flags;				/* See XTENSA_OPCODE_* flags.  */
  xtensa_opcode_encode_fn *encode_fns;	/* Array[slot_id].  */
  int num_funcUnit_uses;		/* Number of funcUnit_use entries.  */
  xtensa_funcUnit_use *funcUnit_uses;	/* Array[num_funcUnit_uses].  */
} xtensa_opcode_internal;

typedef struct xtensa_regfile_internal_struct
{
  const char *name;			/* Full name of the regfile.  */
  const char *shortname;		/* Abbreviated name.  */
  xtensa_regfile parent;		/* View parent (or identity).  */
  int num_bits;				/* Width of the registers.  */
  int num_entries;			/* Number of registers.  */
} xtensa_regfile_internal;

typedef struct xtensa_interface_internal_struct
{
  const char *name;			/* Interface name.  */
  int num_bits;				/* Width of the interface.  */
  uint32 flags;				/* See XTENSA_INTERFACE_* flags.  */
  int class_id;				/* Class of related interfaces.  */
  char inout;				/* "i" or "o".  */
} xtensa_interface_internal;

typedef struct xtensa_funcUnit_internal_struct
{
  const char *name;			/* Functional unit name.  */
  int num_copies;			/* Number of instances.  */
} xtensa_funcUnit_internal;

typedef struct xtensa_state_internal_struct
{
  const char *name;			/* State name.  */
  int num_bits;				/* Number of state bits.  */
  uint32 flags;				/* See XTENSA_STATE_* flags.  */
} xtensa_state_internal;

typedef struct xtensa_sysreg_internal_struct
{
  const char *name;			/* Register name.  */
  int number;				/* Register number.  */
  int is_user;				/* Non-zero if a "user register".  */
} xtensa_sysreg_internal;

typedef struct xtensa_lookup_entry_struct
{
  const char *key;
  union
  {
    xtensa_opcode opcode;		/* Internal opcode number.  */
    xtensa_sysreg sysreg;		/* Internal sysreg number.  */
    xtensa_state state;			/* Internal state number.  */
    xtensa_interface intf;		/* Internal interface number.  */
    xtensa_funcUnit fun;		/* Internal funcUnit number.  */
  } u;
} xtensa_lookup_entry;

typedef struct xtensa_isa_internal_struct
{
  int is_big_endian;			/* Endianness.  */
  int insn_size;			/* Maximum length in bytes.  */
  int insnbuf_size;			/* Number of insnbuf_words.  */

  int num_formats;
  xtensa_format_internal *formats;
  xtensa_format_decode_fn format_decode_fn;
  xtensa_length_decode_fn length_decode_fn;

  int num_slots;
  xtensa_slot_internal *slots;

  int num_fields;

  int num_operands;
  xtensa_operand_internal *operands;

  int num_iclasses;
  xtensa_iclass_internal *iclasses;

  int num_opcodes;
  xtensa_opcode_internal *opcodes;
  xtensa_lookup_entry *opname_lookup_table;

  int num_regfiles;
  xtensa_regfile_internal *regfiles;

  int num_states;
  xtensa_state_internal *states;
  xtensa_lookup_entry *state_lookup_table;

  int num_sysregs;
  xtensa_sysreg_internal *sysregs;
  xtensa_lookup_entry *sysreg_lookup_table;

  /* The current Xtensa ISA only supports 256 of each kind of sysreg so
     we can get away with implementing lookups with tables indexed by
     the register numbers.  If we ever allow larger sysreg numbers, this
     may have to be reimplemented.  The first entry in the following
     arrays corresponds to "special" registers and the second to "user"
     registers.  */
  int max_sysreg_num[2];
  xtensa_sysreg *sysreg_table[2];

  int num_interfaces;
  xtensa_interface_internal *interfaces;
  xtensa_lookup_entry *interface_lookup_table;

  int num_funcUnits;
  xtensa_funcUnit_internal *funcUnits;
  xtensa_lookup_entry *funcUnit_lookup_table;

} xtensa_isa_internal;

extern int xtensa_isa_name_compare (const void *, const void *);

extern xtensa_isa_status xtisa_errno;
extern char xtisa_error_msg[];

#endif /* !XTENSA_ISA_INTERNAL_H */
Commit	Line	Data
e0001a05	1	/* Internal definitions for configurable Xtensa ISA support.
e4e42b45	2	Copyright 2003, 2004, 2005, 2008, 2010 Free Software Foundation, Inc.
e0001a05 NC	3
	4	This file is part of BFD, the Binary File Descriptor library.
	5
	6	This program is free software; you can redistribute it and/or modify
	7	it under the terms of the GNU General Public License as published by
e4e42b45	8	the Free Software Foundation; either version 3 of the License, or
e0001a05 NC	9	(at your option) any later version.
	10
	11	This program is distributed in the hope that it will be useful,
	12	but WITHOUT ANY WARRANTY; without even the implied warranty of
	13	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	14	GNU General Public License for more details.
	15
	16	You should have received a copy of the GNU General Public License
	17	along with this program; if not, write to the Free Software
1fa3cd83 SA	18	Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301,
1fa3cd83 SA	19	USA. */
e0001a05	20
43cd72b9 BW	21	#ifndef XTENSA_ISA_INTERNAL_H
43cd72b9 BW	22	#define XTENSA_ISA_INTERNAL_H
e0001a05	23
43cd72b9	24	/* Flags. */
e0001a05	25
43cd72b9 BW	26	#define XTENSA_OPERAND_IS_REGISTER 0x00000001
	27	#define XTENSA_OPERAND_IS_PCRELATIVE 0x00000002
	28	#define XTENSA_OPERAND_IS_INVISIBLE 0x00000004
	29	#define XTENSA_OPERAND_IS_UNKNOWN 0x00000008
e0001a05	30
43cd72b9 BW	31	#define XTENSA_OPCODE_IS_BRANCH 0x00000001
	32	#define XTENSA_OPCODE_IS_JUMP 0x00000002
	33	#define XTENSA_OPCODE_IS_LOOP 0x00000004
	34	#define XTENSA_OPCODE_IS_CALL 0x00000008
e0001a05	35
43cd72b9	36	#define XTENSA_STATE_IS_EXPORTED 0x00000001
1fa3cd83	37	#define XTENSA_STATE_IS_SHARED_OR 0x00000002
e0001a05	38
43cd72b9	39	#define XTENSA_INTERFACE_HAS_SIDE_EFFECT 0x00000001
e0001a05	40
43cd72b9 BW	41	/* Function pointer typedefs */
	42	typedef void (*xtensa_format_encode_fn) (xtensa_insnbuf);
	43	typedef void (*xtensa_get_slot_fn) (const xtensa_insnbuf, xtensa_insnbuf);
	44	typedef void (*xtensa_set_slot_fn) (xtensa_insnbuf, const xtensa_insnbuf);
	45	typedef int (*xtensa_opcode_decode_fn) (const xtensa_insnbuf);
	46	typedef uint32 (*xtensa_get_field_fn) (const xtensa_insnbuf);
	47	typedef void (*xtensa_set_field_fn) (xtensa_insnbuf, uint32);
	48	typedef int (xtensa_immed_decode_fn) (uint32 );
	49	typedef int (xtensa_immed_encode_fn) (uint32 );
	50	typedef int (xtensa_do_reloc_fn) (uint32 , uint32);
	51	typedef int (xtensa_undo_reloc_fn) (uint32 , uint32);
	52	typedef void (*xtensa_opcode_encode_fn) (xtensa_insnbuf);
	53	typedef int (*xtensa_format_decode_fn) (const xtensa_insnbuf);
f075ee0c	54	typedef int (xtensa_length_decode_fn) (const unsigned char );
43cd72b9 BW	55
	56	typedef struct xtensa_format_internal_struct
	57	{
	58	const char name; / Instruction format name. */
	59	int length; /* Instruction length in bytes. */
	60	xtensa_format_encode_fn encode_fn;
	61	int num_slots;
	62	int slot_id; / Array[num_slots] of slot IDs. */
	63	} xtensa_format_internal;
	64
	65	typedef struct xtensa_slot_internal_struct
	66	{
	67	const char name; / Not necessarily unique. */
	68	const char *format;
	69	int position;
	70	xtensa_get_slot_fn get_fn;
	71	xtensa_set_slot_fn set_fn;
	72	xtensa_get_field_fn get_field_fns; / Array[field_id]. */
	73	xtensa_set_field_fn set_field_fns; / Array[field_id]. */
	74	xtensa_opcode_decode_fn opcode_decode_fn;
	75	const char *nop_name;
	76	} xtensa_slot_internal;
e0001a05 NC	77
	78	typedef struct xtensa_operand_internal_struct
	79	{
43cd72b9 BW	80	const char *name;
	81	int field_id;
	82	xtensa_regfile regfile; /* Register file. */
	83	int num_regs; /* Usually 1; 2 for reg pairs, etc. */
	84	uint32 flags; /* See XTENSA_OPERAND_* flags. */
e0001a05 NC	85	xtensa_immed_encode_fn encode; /* Encode the operand value. */
e0001a05 NC	86	xtensa_immed_decode_fn decode; /* Decode the value from the field. */
43cd72b9	87	xtensa_do_reloc_fn do_reloc; /* Perform a PC-relative reloc. */
e0001a05 NC	88	xtensa_undo_reloc_fn undo_reloc; /* Undo a PC-relative relocation. */
	89	} xtensa_operand_internal;
	90
43cd72b9 BW	91	typedef struct xtensa_arg_internal_struct
	92	{
	93	union {
	94	int operand_id; /* For normal operands. */
	95	xtensa_state state; /* For stateOperands. */
	96	} u;
	97	char inout; /* Direction: 'i', 'o', or 'm'. */
	98	} xtensa_arg_internal;
e0001a05 NC	99
	100	typedef struct xtensa_iclass_internal_struct
	101	{
	102	int num_operands; /* Size of "operands" array. */
43cd72b9	103	xtensa_arg_internal operands; / Array[num_operands]. */
e0001a05	104
43cd72b9 BW	105	int num_stateOperands; /* Size of "stateOperands" array. */
	106	xtensa_arg_internal stateOperands; / Array[num_stateOperands]. */
	107
	108	int num_interfaceOperands; /* Size of "interfaceOperands". */
	109	xtensa_interface interfaceOperands; / Array[num_interfaceOperands]. */
	110	} xtensa_iclass_internal;
e0001a05 NC	111
	112	typedef struct xtensa_opcode_internal_struct
	113	{
	114	const char name; / Opcode mnemonic. */
43cd72b9 BW	115	int iclass_id; /* Iclass for this opcode. */
	116	uint32 flags; /* See XTENSA_OPCODE_* flags. */
	117	xtensa_opcode_encode_fn encode_fns; / Array[slot_id]. */
	118	int num_funcUnit_uses; /* Number of funcUnit_use entries. */
	119	xtensa_funcUnit_use funcUnit_uses; / Array[num_funcUnit_uses]. */
e0001a05 NC	120	} xtensa_opcode_internal;
e0001a05 NC	121
43cd72b9 BW	122	typedef struct xtensa_regfile_internal_struct
	123	{
	124	const char name; / Full name of the regfile. */
	125	const char shortname; / Abbreviated name. */
	126	xtensa_regfile parent; /* View parent (or identity). */
	127	int num_bits; /* Width of the registers. */
	128	int num_entries; /* Number of registers. */
	129	} xtensa_regfile_internal;
	130
	131	typedef struct xtensa_interface_internal_struct
	132	{
	133	const char name; / Interface name. */
	134	int num_bits; /* Width of the interface. */
	135	uint32 flags; /* See XTENSA_INTERFACE_* flags. */
a1ace8d8	136	int class_id; /* Class of related interfaces. */
43cd72b9 BW	137	char inout; /* "i" or "o". */
	138	} xtensa_interface_internal;
	139
	140	typedef struct xtensa_funcUnit_internal_struct
	141	{
	142	const char name; / Functional unit name. */
	143	int num_copies; /* Number of instances. */
	144	} xtensa_funcUnit_internal;
e0001a05	145
43cd72b9	146	typedef struct xtensa_state_internal_struct
e0001a05	147	{
43cd72b9 BW	148	const char name; / State name. */
	149	int num_bits; /* Number of state bits. */
	150	uint32 flags; /* See XTENSA_STATE_* flags. */
	151	} xtensa_state_internal;
e0001a05	152
43cd72b9 BW	153	typedef struct xtensa_sysreg_internal_struct
	154	{
	155	const char name; / Register name. */
	156	int number; /* Register number. */
	157	int is_user; /* Non-zero if a "user register". */
	158	} xtensa_sysreg_internal;
	159
	160	typedef struct xtensa_lookup_entry_struct
	161	{
	162	const char *key;
	163	union
	164	{
	165	xtensa_opcode opcode; /* Internal opcode number. */
	166	xtensa_sysreg sysreg; /* Internal sysreg number. */
	167	xtensa_state state; /* Internal state number. */
	168	xtensa_interface intf; /* Internal interface number. */
	169	xtensa_funcUnit fun; /* Internal funcUnit number. */
	170	} u;
	171	} xtensa_lookup_entry;
e0001a05 NC	172
	173	typedef struct xtensa_isa_internal_struct
	174	{
	175	int is_big_endian; /* Endianness. */
	176	int insn_size; /* Maximum length in bytes. */
	177	int insnbuf_size; /* Number of insnbuf_words. */
e0001a05	178
43cd72b9 BW	179	int num_formats;
	180	xtensa_format_internal *formats;
	181	xtensa_format_decode_fn format_decode_fn;
	182	xtensa_length_decode_fn length_decode_fn;
e0001a05	183
43cd72b9 BW	184	int num_slots;
	185	xtensa_slot_internal *slots;
	186
	187	int num_fields;
	188
	189	int num_operands;
	190	xtensa_operand_internal *operands;
	191
	192	int num_iclasses;
	193	xtensa_iclass_internal *iclasses;
	194
	195	int num_opcodes;
	196	xtensa_opcode_internal *opcodes;
	197	xtensa_lookup_entry *opname_lookup_table;
	198
	199	int num_regfiles;
	200	xtensa_regfile_internal *regfiles;
	201
	202	int num_states;
	203	xtensa_state_internal *states;
	204	xtensa_lookup_entry *state_lookup_table;
	205
	206	int num_sysregs;
	207	xtensa_sysreg_internal *sysregs;
	208	xtensa_lookup_entry *sysreg_lookup_table;
	209
	210	/* The current Xtensa ISA only supports 256 of each kind of sysreg so
	211	we can get away with implementing lookups with tables indexed by
	212	the register numbers. If we ever allow larger sysreg numbers, this
	213	may have to be reimplemented. The first entry in the following
	214	arrays corresponds to "special" registers and the second to "user"
	215	registers. */
	216	int max_sysreg_num[2];
	217	xtensa_sysreg *sysreg_table[2];
	218
	219	int num_interfaces;
	220	xtensa_interface_internal *interfaces;
	221	xtensa_lookup_entry *interface_lookup_table;
	222
	223	int num_funcUnits;
	224	xtensa_funcUnit_internal *funcUnits;
	225	xtensa_lookup_entry *funcUnit_lookup_table;
	226
	227	} xtensa_isa_internal;
	228
	229	extern int xtensa_isa_name_compare (const void , const void );
e0001a05	230
43cd72b9 BW	231	extern xtensa_isa_status xtisa_errno;
43cd72b9 BW	232	extern char xtisa_error_msg[];
e0001a05	233
43cd72b9	234	#endif /* !XTENSA_ISA_INTERNAL_H */