412 lines
15 KiB
C
412 lines
15 KiB
C
/* TI PRU opcode list for GAS, the GNU assembler.
|
|
Copyright (C) 2014-2016 Free Software Foundation, Inc.
|
|
Contributed by Dimitar Dimitrov <dimitar@dinux.eu>
|
|
|
|
This file is part of GAS, the GNU Assembler, and GDB, the GNU disassembler.
|
|
|
|
GAS/GDB 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, or (at your option)
|
|
any later version.
|
|
|
|
GAS/GDB 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 GAS or GDB; see the file COPYING3. If not, write to
|
|
the Free Software Foundation, 51 Franklin Street - Fifth Floor,
|
|
Boston, MA 02110-1301, USA. */
|
|
|
|
#ifndef _PRU_H_
|
|
#define _PRU_H_
|
|
|
|
#include "bfd.h"
|
|
|
|
/****************************************************************************
|
|
* This file contains structures, bit masks and shift counts used
|
|
* by the GNU toolchain to define the PRU instruction set and
|
|
* access various opcode fields.
|
|
****************************************************************************/
|
|
|
|
/* Identify different overflow situations for error messages. */
|
|
enum overflow_type
|
|
{
|
|
call_target_overflow = 0,
|
|
qbranch_target_overflow,
|
|
address_offset_overflow,
|
|
signed_immed16_overflow,
|
|
unsigned_immed32_overflow,
|
|
unsigned_immed16_overflow,
|
|
unsigned_immed8_overflow,
|
|
unsigned_immed5_overflow,
|
|
no_overflow
|
|
};
|
|
|
|
enum opcode_format_type {
|
|
opcode_format1,
|
|
opcode_format2ab,
|
|
opcode_format2abl,
|
|
opcode_format2c,
|
|
opcode_format2de,
|
|
opcode_format45,
|
|
opcode_format6
|
|
};
|
|
|
|
/* Opcode ID listing. Used for indexing by the simulator. */
|
|
enum pru_instr_type {
|
|
prui_add, prui_adc, prui_sub, prui_suc, prui_lsl, prui_lsr, prui_rsb,
|
|
prui_rsc, prui_and, prui_or, prui_xor, prui_min, prui_max, prui_clr,
|
|
prui_set, prui_not, prui_jmp, prui_jal, prui_ldi, prui_halt, prui_slp,
|
|
prui_xin, prui_xout, prui_xchg, prui_sxin, prui_sxout, prui_sxchg,
|
|
prui_loop, prui_iloop, prui_qbgt, prui_qbge, prui_qblt, prui_qble,
|
|
prui_qbeq, prui_qbne, prui_qba, prui_qbbs, prui_qbbc, prui_lbbo,
|
|
prui_sbbo, prui_lbco, prui_sbco
|
|
};
|
|
|
|
/* This structure holds information for a particular instruction.
|
|
|
|
The args field is a string describing the operands. The following
|
|
letters can appear in the args:
|
|
b - a 5.3-bit right source register index OR 8-bit unsigned immediate
|
|
B - same as 'b', but for LOOP instruction where IMM is decremented
|
|
c - a 5 bit unsigned immediate for constant table offset
|
|
d - a 5.3-bit destination register index
|
|
D - a 5.2-bit destination register index
|
|
E - for internal GAS self-tests only
|
|
i - a 32-bit immediate or label
|
|
j - a 5.3-bit right source register index OR 18-bit PC address
|
|
l - burst length (unsigned 7-bit immediate or r0.b[0-3]) for xLBCO
|
|
n - burst length (unsigned 7-bit immediate or r0.b[0-3]) for XFR
|
|
o - a 10-bit signed PC-relative offset
|
|
O - an 8-bit unsigned PC-relative offset for LOOP termination point
|
|
R - a 5-bit destination register index
|
|
s - a 5.3-bit left source register index
|
|
S - a 5-bit left source register index
|
|
w - a single bit for "WakeOnStatus"
|
|
W - a 16-bit unsigned immediate with IO=0 field (LDI)
|
|
x - an 8-bit XFR wide-bus address immediate
|
|
Literal ',' character may also appear in the args as delimiter.
|
|
|
|
Most of the macro names are from [1].
|
|
|
|
The pinfo field is INSN_MACRO for a macro. Otherwise, it is a collection
|
|
of bits describing the instruction, notably any relevant hazard
|
|
information.
|
|
|
|
When assembling, the match field contains the opcode template, which
|
|
is modified by the arguments to produce the actual opcode
|
|
that is emitted. If pinfo is INSN_MACRO, then this is 0.
|
|
|
|
If pinfo is INSN_MACRO, the mask field stores the macro identifier.
|
|
Otherwise this is a bit mask for the relevant portions of the opcode
|
|
when disassembling. If the actual opcode anded with the match field
|
|
equals the opcode field, then we have found the correct instruction.
|
|
|
|
[1] http://processors.wiki.ti.com/index.php/Programmable_Realtime_Unit */
|
|
|
|
struct pru_opcode
|
|
{
|
|
const char *name; /* The name of the instruction. */
|
|
enum pru_instr_type type; /* Instruction type. Used for fast indexing
|
|
by the simulator. */
|
|
const char *args; /* A string describing the arguments for this
|
|
instruction. */
|
|
unsigned long match; /* The basic opcode for the instruction. */
|
|
unsigned long mask; /* Mask for the opcode field of the
|
|
instruction. */
|
|
unsigned long pinfo; /* Is this a real instruction or instruction
|
|
macro? */
|
|
enum overflow_type overflow_msg; /* Used to generate informative
|
|
message when fixup overflows. */
|
|
};
|
|
|
|
/* This value is used in the pru_opcode.pinfo field to indicate that the
|
|
instruction is a macro or pseudo-op. This requires special treatment by
|
|
the assembler, and is used by the disassembler to determine whether to
|
|
check for a nop. */
|
|
#define PRU_INSN_MACRO 0x80000000
|
|
|
|
/* This macro is specially handled throughout the code because it is
|
|
the only insn to output 2 words (64 bits). */
|
|
#define PRU_INSN_LDI32 0x40000000
|
|
|
|
/* Associates a register name with a 5-bit index and 3-bit regsel. */
|
|
struct pru_reg
|
|
{
|
|
const char *name; /* Name, e.g. "r10". */
|
|
const unsigned int index; /* Index, e.g. 10. */
|
|
const unsigned int regsel; /* Register field selector, .e.g RSEL_31_0. */
|
|
};
|
|
|
|
/* Macros for getting and setting an instruction field. */
|
|
#define GET_INSN_FIELD(X, i) \
|
|
(((i) & OP_MASK_##X) >> OP_SH_##X)
|
|
#define SET_INSN_FIELD(X, i, v) \
|
|
((i) = (((i) & ~OP_MASK_##X) | (((v) << OP_SH_##X) & OP_MASK_##X)))
|
|
|
|
#define CHECK_INSN_FIELD(X, i) \
|
|
(((i) & OP_MASK_##X) == OP_MATCH_##X)
|
|
|
|
/* Masks, values, shifts and macros for accessing the various opcode fields. */
|
|
|
|
#define OP_SH_FMT1_OP 29
|
|
#define OP_MASK_FMT1_OP (0x7u << 29)
|
|
#define OP_MATCH_FMT1_OP (0x0u << 29)
|
|
|
|
#define OP_SH_FMT2_OP 29
|
|
#define OP_MASK_FMT2_OP (0x7u << 29)
|
|
#define OP_MATCH_FMT2_OP (0x1u << 29)
|
|
|
|
#define OP_SH_FMT4_OP 30
|
|
#define OP_MASK_FMT4_OP (0x3u << 30)
|
|
#define OP_MATCH_FMT4_OP (0x1u << 30)
|
|
|
|
#define OP_SH_FMT5_OP 29
|
|
#define OP_MASK_FMT5_OP (0x7u << 29)
|
|
#define OP_MATCH_FMT5_OP (0x6u << 29)
|
|
|
|
#define OP_SH_FMT6AB_OP 29
|
|
#define OP_MASK_FMT6AB_OP (0x7u << 29)
|
|
#define OP_MATCH_FMT6AB_OP (0x7u << 29)
|
|
|
|
#define OP_SH_FMT6CD_OP 29
|
|
#define OP_MASK_FMT6CD_OP (0x7u << 29)
|
|
#define OP_MATCH_FMT6CD_OP (0x4u << 29)
|
|
|
|
/* Generic fields. */
|
|
#define OP_SH_SUBOP 25
|
|
#define OP_MASK_SUBOP (0xfu << 25)
|
|
|
|
#define OP_SH_IO 24
|
|
#define OP_MASK_IO (0x1u << 24)
|
|
|
|
#define OP_SH_RS2SEL 21
|
|
#define OP_MASK_RS2SEL (0x7u << 21)
|
|
#define OP_SH_RS2 16
|
|
#define OP_MASK_RS2 (0x1fu << 16)
|
|
#define OP_SH_RS1SEL 13
|
|
#define OP_MASK_RS1SEL (0x7u << 13)
|
|
#define OP_SH_RS1 8
|
|
#define OP_MASK_RS1 (0x1fu << 8)
|
|
#define OP_SH_RDSEL 5
|
|
#define OP_MASK_RDSEL (0x7u << 5)
|
|
#define OP_SH_RD 0
|
|
#define OP_MASK_RD (0x1fu << 0)
|
|
#define OP_SH_IMM8 16
|
|
#define OP_MASK_IMM8 (0xffu << 16)
|
|
#define OP_SH_IMM16 8
|
|
#define OP_MASK_IMM16 (0xffffu << 8)
|
|
|
|
#define RSEL_7_0 0u
|
|
#define RSEL_15_8 1u
|
|
#define RSEL_23_16 2u
|
|
#define RSEL_31_24 3u
|
|
#define RSEL_15_0 4u
|
|
#define RSEL_23_8 5u
|
|
#define RSEL_31_16 6u
|
|
#define RSEL_31_0 7u
|
|
#define RSEL_NUM_ITEMS 8u
|
|
|
|
/* Format 1 specific fields. */
|
|
#define SUBOP_ADD 0u
|
|
#define SUBOP_ADC 1u
|
|
#define SUBOP_SUB 2u
|
|
#define SUBOP_SUC 3u
|
|
#define SUBOP_LSL 4u
|
|
#define SUBOP_LSR 5u
|
|
#define SUBOP_RSB 6u
|
|
#define SUBOP_RSC 7u
|
|
#define SUBOP_AND 8u
|
|
#define SUBOP_OR 9u
|
|
#define SUBOP_XOR 10u
|
|
#define SUBOP_NOT 11u
|
|
#define SUBOP_MIN 12u
|
|
#define SUBOP_MAX 13u
|
|
#define SUBOP_CLR 14u
|
|
#define SUBOP_SET 15u
|
|
|
|
/* Format 2 specific fields. */
|
|
#define SUBOP_JMP 0u
|
|
#define SUBOP_JAL 1u
|
|
#define SUBOP_LDI 2u
|
|
#define SUBOP_LMBD 3u
|
|
#define SUBOP_SCAN 4u
|
|
#define SUBOP_HALT 5u
|
|
#define SUBOP_RSVD_FOR_MVIx 6u
|
|
#define SUBOP_XFR 7u
|
|
#define SUBOP_LOOP 8u
|
|
#define SUBOP_RSVD_FOR_RFI 14u
|
|
#define SUBOP_SLP 15u
|
|
|
|
#define OP_SH_WAKEONSTATUS 23
|
|
#define OP_MASK_WAKEONSTATUS (0x1u << 23)
|
|
|
|
/* Format 2 XFR specific fields. */
|
|
#define OP_SH_SUBOP_XFR 23
|
|
#define OP_MASK_SUBOP_XFR (3u << 23)
|
|
#define OP_SH_XFR_WBA 15
|
|
#define OP_MASK_XFR_WBA (0xffu << 15)
|
|
#define OP_SH_XFR_S 14
|
|
#define OP_MASK_XFR_S (1u << 14)
|
|
#define OP_SH_XFR_LENGTH 7
|
|
#define OP_MASK_XFR_LENGTH (0x7fu << 7)
|
|
|
|
#define SUBOP_XFR_XIN 1u
|
|
#define SUBOP_XFR_XOUT 2u
|
|
#define SUBOP_XFR_XCHG 3u
|
|
|
|
/* Format 2 LOOP specific fields. */
|
|
#define OP_SH_LOOP_INTERRUPTIBLE 15
|
|
#define OP_MASK_LOOP_INTERRUPTIBLE (1u << 15)
|
|
#define OP_SH_LOOP_JMPOFFS 0
|
|
#define OP_MASK_LOOP_JMPOFFS (0xffu << 0)
|
|
|
|
/* Format 4 specific fields. */
|
|
#define OP_SH_BROFF98 25
|
|
#define OP_MASK_BROFF98 (0x3u << 25)
|
|
#define OP_SH_BROFF70 0
|
|
#define OP_MASK_BROFF70 (0xffu << 0)
|
|
#define OP_SH_GT 29
|
|
#define OP_MASK_GT (0x1u << 29)
|
|
#define OP_SH_EQ 28
|
|
#define OP_MASK_EQ (0x1u << 28)
|
|
#define OP_SH_LT 27
|
|
#define OP_MASK_LT (0x1u << 27)
|
|
#define OP_MASK_CMP (OP_MASK_GT | OP_MASK_EQ | OP_MASK_LT)
|
|
|
|
|
|
/* Format 5 specific fields. */
|
|
#define OP_SH_BS 28
|
|
#define OP_MASK_BS (0x1u << 28)
|
|
#define OP_SH_BC 27
|
|
#define OP_MASK_BC (0x1u << 27)
|
|
#define OP_MASK_BCMP (OP_MASK_BS | OP_MASK_BC)
|
|
|
|
/* Format 6 specific fields. */
|
|
#define OP_SH_LOADSTORE 28
|
|
#define OP_MASK_LOADSTORE (0x1u << 28)
|
|
#define OP_SH_BURSTLEN64 25
|
|
#define OP_MASK_BURSTLEN64 (0x7u << 25)
|
|
#define OP_SH_BURSTLEN31 13
|
|
#define OP_MASK_BURSTLEN31 (0x7u << 13)
|
|
#define OP_SH_CB 8
|
|
#define OP_MASK_CB (0x1fu << 8)
|
|
#define OP_SH_BURSTLEN0 7
|
|
#define OP_MASK_BURSTLEN0 (0x1u << 7)
|
|
#define OP_SH_RDB 5
|
|
#define OP_MASK_RDB (0x3u << 5)
|
|
|
|
#define LSSBBO_BYTECOUNT_R0_BITS7_0 124u
|
|
#define LSBBO_BYTECOUNT_R0_BITS15_8 125u
|
|
#define LSBBO_BYTECOUNT_R0_BITS23_16 126u
|
|
#define LSBBO_BYTECOUNT_R0_BITS31_24 127u
|
|
|
|
/* The following macros define the opcode matches for each
|
|
instruction code & OP_MASK_INST == OP_MATCH_INST. */
|
|
#define OP_MATCH_ADD (OP_MATCH_FMT1_OP | (SUBOP_ADD << OP_SH_SUBOP))
|
|
#define OP_MATCH_ADC (OP_MATCH_FMT1_OP | (SUBOP_ADC << OP_SH_SUBOP))
|
|
#define OP_MATCH_SUB (OP_MATCH_FMT1_OP | (SUBOP_SUB << OP_SH_SUBOP))
|
|
#define OP_MATCH_SUC (OP_MATCH_FMT1_OP | (SUBOP_SUC << OP_SH_SUBOP))
|
|
#define OP_MATCH_LSL (OP_MATCH_FMT1_OP | (SUBOP_LSL << OP_SH_SUBOP))
|
|
#define OP_MATCH_LSR (OP_MATCH_FMT1_OP | (SUBOP_LSR << OP_SH_SUBOP))
|
|
#define OP_MATCH_RSB (OP_MATCH_FMT1_OP | (SUBOP_RSB << OP_SH_SUBOP))
|
|
#define OP_MATCH_RSC (OP_MATCH_FMT1_OP | (SUBOP_RSC << OP_SH_SUBOP))
|
|
#define OP_MATCH_AND (OP_MATCH_FMT1_OP | (SUBOP_AND << OP_SH_SUBOP))
|
|
#define OP_MATCH_OR (OP_MATCH_FMT1_OP | (SUBOP_OR << OP_SH_SUBOP))
|
|
#define OP_MATCH_XOR (OP_MATCH_FMT1_OP | (SUBOP_XOR << OP_SH_SUBOP))
|
|
#define OP_MATCH_NOT (OP_MATCH_FMT1_OP | (SUBOP_NOT << OP_SH_SUBOP))
|
|
#define OP_MATCH_MIN (OP_MATCH_FMT1_OP | (SUBOP_MIN << OP_SH_SUBOP))
|
|
#define OP_MATCH_MAX (OP_MATCH_FMT1_OP | (SUBOP_MAX << OP_SH_SUBOP))
|
|
#define OP_MATCH_CLR (OP_MATCH_FMT1_OP | (SUBOP_CLR << OP_SH_SUBOP))
|
|
#define OP_MATCH_SET (OP_MATCH_FMT1_OP | (SUBOP_SET << OP_SH_SUBOP))
|
|
|
|
#define OP_MATCH_JMP (OP_MATCH_FMT2_OP | (SUBOP_JMP << OP_SH_SUBOP))
|
|
#define OP_MATCH_JAL (OP_MATCH_FMT2_OP | (SUBOP_JAL << OP_SH_SUBOP))
|
|
#define OP_MATCH_LDI (OP_MATCH_FMT2_OP | (SUBOP_LDI << OP_SH_SUBOP))
|
|
#define OP_MATCH_LMBD (OP_MATCH_FMT2_OP | (SUBOP_LMBD << OP_SH_SUBOP))
|
|
#define OP_MATCH_SCAN (OP_MATCH_FMT2_OP | (SUBOP_SCAN << OP_SH_SUBOP))
|
|
#define OP_MATCH_HALT (OP_MATCH_FMT2_OP | (SUBOP_HALT << OP_SH_SUBOP))
|
|
#define OP_MATCH_SLP (OP_MATCH_FMT2_OP | (SUBOP_SLP << OP_SH_SUBOP))
|
|
#define OP_MATCH_XFR (OP_MATCH_FMT2_OP | (SUBOP_XFR << OP_SH_SUBOP))
|
|
#define OP_MATCH_SXFR (OP_MATCH_XFR | OP_MASK_XFR_S)
|
|
#define OP_MATCH_XIN (OP_MATCH_XFR | (SUBOP_XFR_XIN << OP_SH_SUBOP_XFR))
|
|
#define OP_MATCH_XOUT (OP_MATCH_XFR | (SUBOP_XFR_XOUT << OP_SH_SUBOP_XFR))
|
|
#define OP_MATCH_XCHG (OP_MATCH_XFR | (SUBOP_XFR_XCHG << OP_SH_SUBOP_XFR))
|
|
#define OP_MATCH_SXIN (OP_MATCH_SXFR | (SUBOP_XFR_XIN << OP_SH_SUBOP_XFR))
|
|
#define OP_MATCH_SXOUT (OP_MATCH_SXFR | (SUBOP_XFR_XOUT << OP_SH_SUBOP_XFR))
|
|
#define OP_MATCH_SXCHG (OP_MATCH_SXFR | (SUBOP_XFR_XCHG << OP_SH_SUBOP_XFR))
|
|
#define OP_MATCH_LOOP (OP_MATCH_FMT2_OP | (SUBOP_LOOP << OP_SH_SUBOP))
|
|
#define OP_MATCH_ILOOP (OP_MATCH_FMT2_OP | (SUBOP_LOOP << OP_SH_SUBOP) \
|
|
| OP_MASK_LOOP_INTERRUPTIBLE)
|
|
|
|
#define OP_MATCH_QBGT (OP_MATCH_FMT4_OP | OP_MASK_GT)
|
|
#define OP_MATCH_QBGE (OP_MATCH_FMT4_OP | OP_MASK_GT | OP_MASK_EQ)
|
|
#define OP_MATCH_QBLT (OP_MATCH_FMT4_OP | OP_MASK_LT)
|
|
#define OP_MATCH_QBLE (OP_MATCH_FMT4_OP | OP_MASK_LT | OP_MASK_EQ)
|
|
#define OP_MATCH_QBEQ (OP_MATCH_FMT4_OP | OP_MASK_EQ)
|
|
#define OP_MATCH_QBNE (OP_MATCH_FMT4_OP | OP_MASK_GT | OP_MASK_LT)
|
|
#define OP_MATCH_QBA (OP_MATCH_FMT4_OP | OP_MASK_GT | OP_MASK_LT \
|
|
| OP_MASK_EQ)
|
|
|
|
#define OP_MATCH_QBBS (OP_MATCH_FMT5_OP | OP_MASK_BS)
|
|
#define OP_MATCH_QBBC (OP_MATCH_FMT5_OP | OP_MASK_BC)
|
|
|
|
#define OP_MATCH_LBBO (OP_MATCH_FMT6AB_OP | OP_MASK_LOADSTORE)
|
|
#define OP_MATCH_SBBO (OP_MATCH_FMT6AB_OP)
|
|
#define OP_MATCH_LBCO (OP_MATCH_FMT6CD_OP | OP_MASK_LOADSTORE)
|
|
#define OP_MATCH_SBCO (OP_MATCH_FMT6CD_OP)
|
|
|
|
/* Some special extractions. */
|
|
#define OP_MASK_BROFF (OP_MASK_BROFF98 | OP_MASK_BROFF70)
|
|
|
|
#define GET_BROFF_URAW(i) \
|
|
((GET_INSN_FIELD (BROFF98, i) << 8) | (GET_INSN_FIELD (BROFF70, i) << 0))
|
|
|
|
#define GET_BROFF_SIGNED(i) \
|
|
((long)(GET_BROFF_URAW (i) - (!!(GET_BROFF_URAW (i) & (1 << 9)) << 10)))
|
|
|
|
#define SET_BROFF_URAW(i, v) \
|
|
do { \
|
|
SET_INSN_FIELD (BROFF98, (i), (v) >> 8); \
|
|
SET_INSN_FIELD (BROFF70, (i), (v) & 0xff); \
|
|
} while (0)
|
|
|
|
#define GET_BURSTLEN(i) \
|
|
( (GET_INSN_FIELD (BURSTLEN64, (i)) << 4) | \
|
|
(GET_INSN_FIELD (BURSTLEN31, (i)) << 1) | \
|
|
(GET_INSN_FIELD (BURSTLEN0, (i)) << 0))
|
|
|
|
#define SET_BURSTLEN(i, v) \
|
|
do { \
|
|
SET_INSN_FIELD (BURSTLEN64, (i), (v) >> 4); \
|
|
SET_INSN_FIELD (BURSTLEN31, (i), (v) >> 1); \
|
|
SET_INSN_FIELD (BURSTLEN0, (i), (v) >> 0); \
|
|
} while (0)
|
|
|
|
/* Miscellaneous helpers. */
|
|
#define OP_MASK_XFR_OP (OP_MASK_FMT2_OP | OP_MASK_SUBOP \
|
|
| OP_MASK_SUBOP_XFR | OP_MASK_XFR_S)
|
|
|
|
#define OP_MASK_LOOP_OP (OP_MASK_FMT2_OP | OP_MASK_SUBOP \
|
|
| OP_MASK_LOOP_INTERRUPTIBLE)
|
|
|
|
/* These are the data structures we use to hold the instruction information. */
|
|
extern const struct pru_opcode pru_opcodes[];
|
|
extern const int bfd_pru_num_opcodes;
|
|
|
|
/* These are the data structures used to hold the register information. */
|
|
extern const struct pru_reg pru_regs[];
|
|
extern const int pru_num_regs;
|
|
|
|
/* Machine-independent macro for number of opcodes. */
|
|
#define NUMOPCODES bfd_pru_num_opcodes
|
|
#define NUMREGISTERS pru_num_regs;
|
|
|
|
/* This is made extern so that the assembler can use it to find out
|
|
what instruction caused an error. */
|
|
extern const struct pru_opcode *pru_find_opcode (unsigned long);
|
|
|
|
#endif /* _PRU_H */
|