/* Internal definitions for the Xtensa ISA library. * * Copyright (c) 2004-2011 Tensilica Inc. * * Permission is hereby granted, free of charge, to any person obtaining * a copy of this software and associated documentation files (the * "Software"), to deal in the Software without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to * the following conditions: * * The above copyright notice and this permission notice shall be included * in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ #ifndef XTENSA_ISA_INTERNAL_H #define XTENSA_ISA_INTERNAL_H #ifndef uint32 #define uint32 uint32_t #endif /* 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_t (*xtensa_get_field_fn)(const xtensa_insnbuf); typedef void (*xtensa_set_field_fn)(xtensa_insnbuf, uint32_t); typedef int (*xtensa_immed_decode_fn)(uint32_t *); typedef int (*xtensa_immed_encode_fn)(uint32_t *); typedef int (*xtensa_do_reloc_fn)(uint32_t *, uint32_t); typedef int (*xtensa_undo_reloc_fn)(uint32_t *, uint32_t); 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_t 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_t 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_t 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_t 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; int num_stages; /* Number of pipe stages. */ } xtensa_isa_internal; 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 */