qemu/target/hexagon/decode.c
<<
>>
Prefs
   1/*
   2 *  Copyright(c) 2019-2021 Qualcomm Innovation Center, Inc. All Rights Reserved.
   3 *
   4 *  This program is free software; you can redistribute it and/or modify
   5 *  it under the terms of the GNU General Public License as published by
   6 *  the Free Software Foundation; either version 2 of the License, or
   7 *  (at your option) any later version.
   8 *
   9 *  This program is distributed in the hope that it will be useful,
  10 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 *  GNU General Public License for more details.
  13 *
  14 *  You should have received a copy of the GNU General Public License
  15 *  along with this program; if not, see <http://www.gnu.org/licenses/>.
  16 */
  17
  18#include "qemu/osdep.h"
  19#include "qemu/log.h"
  20#include "iclass.h"
  21#include "attribs.h"
  22#include "genptr.h"
  23#include "decode.h"
  24#include "insn.h"
  25#include "printinsn.h"
  26
  27#define fZXTN(N, M, VAL) ((VAL) & ((1LL << (N)) - 1))
  28
  29enum {
  30    EXT_IDX_noext = 0,
  31    EXT_IDX_noext_AFTER = 4,
  32    EXT_IDX_mmvec = 4,
  33    EXT_IDX_mmvec_AFTER = 8,
  34    XX_LAST_EXT_IDX
  35};
  36
  37/*
  38 *  Certain operand types represent a non-contiguous set of values.
  39 *  For example, the compound compare-and-jump instruction can only access
  40 *  registers R0-R7 and R16-23.
  41 *  This table represents the mapping from the encoding to the actual values.
  42 */
  43
  44#define DEF_REGMAP(NAME, ELEMENTS, ...) \
  45    static const unsigned int DECODE_REGISTER_##NAME[ELEMENTS] = \
  46    { __VA_ARGS__ };
  47        /* Name   Num Table */
  48DEF_REGMAP(R_16,  16, 0, 1, 2, 3, 4, 5, 6, 7, 16, 17, 18, 19, 20, 21, 22, 23)
  49DEF_REGMAP(R__8,  8,  0, 2, 4, 6, 16, 18, 20, 22)
  50
  51#define DECODE_MAPPED_REG(REGNO, NAME) \
  52    insn->regno[REGNO] = DECODE_REGISTER_##NAME[insn->regno[REGNO]];
  53
  54typedef struct {
  55    const struct DectreeTable *table_link;
  56    const struct DectreeTable *table_link_b;
  57    Opcode opcode;
  58    enum {
  59        DECTREE_ENTRY_INVALID,
  60        DECTREE_TABLE_LINK,
  61        DECTREE_SUBINSNS,
  62        DECTREE_EXTSPACE,
  63        DECTREE_TERMINAL
  64    } type;
  65} DectreeEntry;
  66
  67typedef struct DectreeTable {
  68    unsigned int (*lookup_function)(int startbit, int width, uint32_t opcode);
  69    unsigned int size;
  70    unsigned int startbit;
  71    unsigned int width;
  72    const DectreeEntry table[];
  73} DectreeTable;
  74
  75#define DECODE_NEW_TABLE(TAG, SIZE, WHATNOT) \
  76    static const DectreeTable dectree_table_##TAG;
  77#define TABLE_LINK(TABLE)                     /* NOTHING */
  78#define TERMINAL(TAG, ENC)                    /* NOTHING */
  79#define SUBINSNS(TAG, CLASSA, CLASSB, ENC)    /* NOTHING */
  80#define EXTSPACE(TAG, ENC)                    /* NOTHING */
  81#define INVALID()                             /* NOTHING */
  82#define DECODE_END_TABLE(...)                 /* NOTHING */
  83#define DECODE_MATCH_INFO(...)                /* NOTHING */
  84#define DECODE_LEGACY_MATCH_INFO(...)         /* NOTHING */
  85#define DECODE_OPINFO(...)                    /* NOTHING */
  86
  87#include "dectree_generated.h.inc"
  88
  89#undef DECODE_OPINFO
  90#undef DECODE_MATCH_INFO
  91#undef DECODE_LEGACY_MATCH_INFO
  92#undef DECODE_END_TABLE
  93#undef INVALID
  94#undef TERMINAL
  95#undef SUBINSNS
  96#undef EXTSPACE
  97#undef TABLE_LINK
  98#undef DECODE_NEW_TABLE
  99#undef DECODE_SEPARATOR_BITS
 100
 101#define DECODE_SEPARATOR_BITS(START, WIDTH) NULL, START, WIDTH
 102#define DECODE_NEW_TABLE_HELPER(TAG, SIZE, FN, START, WIDTH) \
 103    static const DectreeTable dectree_table_##TAG = { \
 104        .size = SIZE, \
 105        .lookup_function = FN, \
 106        .startbit = START, \
 107        .width = WIDTH, \
 108        .table = {
 109#define DECODE_NEW_TABLE(TAG, SIZE, WHATNOT) \
 110    DECODE_NEW_TABLE_HELPER(TAG, SIZE, WHATNOT)
 111
 112#define TABLE_LINK(TABLE) \
 113    { .type = DECTREE_TABLE_LINK, .table_link = &dectree_table_##TABLE },
 114#define TERMINAL(TAG, ENC) \
 115    { .type = DECTREE_TERMINAL, .opcode = TAG  },
 116#define SUBINSNS(TAG, CLASSA, CLASSB, ENC) \
 117    { \
 118        .type = DECTREE_SUBINSNS, \
 119        .table_link = &dectree_table_DECODE_SUBINSN_##CLASSA, \
 120        .table_link_b = &dectree_table_DECODE_SUBINSN_##CLASSB \
 121    },
 122#define EXTSPACE(TAG, ENC) { .type = DECTREE_EXTSPACE },
 123#define INVALID() { .type = DECTREE_ENTRY_INVALID, .opcode = XX_LAST_OPCODE },
 124
 125#define DECODE_END_TABLE(...) } };
 126
 127#define DECODE_MATCH_INFO(...)                /* NOTHING */
 128#define DECODE_LEGACY_MATCH_INFO(...)         /* NOTHING */
 129#define DECODE_OPINFO(...)                    /* NOTHING */
 130
 131#include "dectree_generated.h.inc"
 132
 133#undef DECODE_OPINFO
 134#undef DECODE_MATCH_INFO
 135#undef DECODE_LEGACY_MATCH_INFO
 136#undef DECODE_END_TABLE
 137#undef INVALID
 138#undef TERMINAL
 139#undef SUBINSNS
 140#undef EXTSPACE
 141#undef TABLE_LINK
 142#undef DECODE_NEW_TABLE
 143#undef DECODE_NEW_TABLE_HELPER
 144#undef DECODE_SEPARATOR_BITS
 145
 146static const DectreeTable dectree_table_DECODE_EXT_EXT_noext = {
 147    .size = 1, .lookup_function = NULL, .startbit = 0, .width = 0,
 148    .table = {
 149        { .type = DECTREE_ENTRY_INVALID, .opcode = XX_LAST_OPCODE },
 150    }
 151};
 152
 153static const DectreeTable *ext_trees[XX_LAST_EXT_IDX];
 154
 155static void decode_ext_init(void)
 156{
 157    int i;
 158    for (i = EXT_IDX_noext; i < EXT_IDX_noext_AFTER; i++) {
 159        ext_trees[i] = &dectree_table_DECODE_EXT_EXT_noext;
 160    }
 161}
 162
 163typedef struct {
 164    uint32_t mask;
 165    uint32_t match;
 166} DecodeITableEntry;
 167
 168#define DECODE_NEW_TABLE(TAG, SIZE, WHATNOT)  /* NOTHING */
 169#define TABLE_LINK(TABLE)                     /* NOTHING */
 170#define TERMINAL(TAG, ENC)                    /* NOTHING */
 171#define SUBINSNS(TAG, CLASSA, CLASSB, ENC)    /* NOTHING */
 172#define EXTSPACE(TAG, ENC)                    /* NOTHING */
 173#define INVALID()                             /* NOTHING */
 174#define DECODE_END_TABLE(...)                 /* NOTHING */
 175#define DECODE_OPINFO(...)                    /* NOTHING */
 176
 177#define DECODE_MATCH_INFO_NORMAL(TAG, MASK, MATCH) \
 178    [TAG] = { \
 179        .mask = MASK, \
 180        .match = MATCH, \
 181    },
 182
 183#define DECODE_MATCH_INFO_NULL(TAG, MASK, MATCH) \
 184    [TAG] = { .match = ~0 },
 185
 186#define DECODE_MATCH_INFO(...) DECODE_MATCH_INFO_NORMAL(__VA_ARGS__)
 187#define DECODE_LEGACY_MATCH_INFO(...) /* NOTHING */
 188
 189static const DecodeITableEntry decode_itable[XX_LAST_OPCODE] = {
 190#include "dectree_generated.h.inc"
 191};
 192
 193#undef DECODE_MATCH_INFO
 194#define DECODE_MATCH_INFO(...) DECODE_MATCH_INFO_NULL(__VA_ARGS__)
 195
 196#undef DECODE_LEGACY_MATCH_INFO
 197#define DECODE_LEGACY_MATCH_INFO(...) DECODE_MATCH_INFO_NORMAL(__VA_ARGS__)
 198
 199static const DecodeITableEntry decode_legacy_itable[XX_LAST_OPCODE] = {
 200#include "dectree_generated.h.inc"
 201};
 202
 203#undef DECODE_OPINFO
 204#undef DECODE_MATCH_INFO
 205#undef DECODE_LEGACY_MATCH_INFO
 206#undef DECODE_END_TABLE
 207#undef INVALID
 208#undef TERMINAL
 209#undef SUBINSNS
 210#undef EXTSPACE
 211#undef TABLE_LINK
 212#undef DECODE_NEW_TABLE
 213#undef DECODE_SEPARATOR_BITS
 214
 215void decode_init(void)
 216{
 217    decode_ext_init();
 218}
 219
 220void decode_send_insn_to(Packet *packet, int start, int newloc)
 221{
 222    Insn tmpinsn;
 223    int direction;
 224    int i;
 225    if (start == newloc) {
 226        return;
 227    }
 228    if (start < newloc) {
 229        /* Move towards end */
 230        direction = 1;
 231    } else {
 232        /* move towards beginning */
 233        direction = -1;
 234    }
 235    for (i = start; i != newloc; i += direction) {
 236        tmpinsn = packet->insn[i];
 237        packet->insn[i] = packet->insn[i + direction];
 238        packet->insn[i + direction] = tmpinsn;
 239    }
 240}
 241
 242/* Fill newvalue registers with the correct regno */
 243static void
 244decode_fill_newvalue_regno(Packet *packet)
 245{
 246    int i, use_regidx, offset, def_idx, dst_idx;
 247    uint16_t def_opcode, use_opcode;
 248    char *dststr;
 249
 250    for (i = 1; i < packet->num_insns; i++) {
 251        if (GET_ATTRIB(packet->insn[i].opcode, A_DOTNEWVALUE) &&
 252            !GET_ATTRIB(packet->insn[i].opcode, A_EXTENSION)) {
 253            use_opcode = packet->insn[i].opcode;
 254
 255            /* It's a store, so we're adjusting the Nt field */
 256            if (GET_ATTRIB(use_opcode, A_STORE)) {
 257                use_regidx = strchr(opcode_reginfo[use_opcode], 't') -
 258                    opcode_reginfo[use_opcode];
 259            } else {    /* It's a Jump, so we're adjusting the Ns field */
 260                use_regidx = strchr(opcode_reginfo[use_opcode], 's') -
 261                    opcode_reginfo[use_opcode];
 262            }
 263
 264            /*
 265             * What's encoded at the N-field is the offset to who's producing
 266             * the value.  Shift off the LSB which indicates odd/even register,
 267             * then walk backwards and skip over the constant extenders.
 268             */
 269            offset = packet->insn[i].regno[use_regidx] >> 1;
 270            def_idx = i - offset;
 271            for (int j = 0; j < offset; j++) {
 272                if (GET_ATTRIB(packet->insn[i - j - 1].opcode, A_IT_EXTENDER)) {
 273                    def_idx--;
 274                }
 275            }
 276
 277            /*
 278             * Check for a badly encoded N-field which points to an instruction
 279             * out-of-range
 280             */
 281            g_assert(!((def_idx < 0) || (def_idx > (packet->num_insns - 1))));
 282
 283            /*
 284             * packet->insn[def_idx] is the producer
 285             * Figure out which type of destination it produces
 286             * and the corresponding index in the reginfo
 287             */
 288            def_opcode = packet->insn[def_idx].opcode;
 289            dststr = strstr(opcode_wregs[def_opcode], "Rd");
 290            if (dststr) {
 291                dststr = strchr(opcode_reginfo[def_opcode], 'd');
 292            } else {
 293                dststr = strstr(opcode_wregs[def_opcode], "Rx");
 294                if (dststr) {
 295                    dststr = strchr(opcode_reginfo[def_opcode], 'x');
 296                } else {
 297                    dststr = strstr(opcode_wregs[def_opcode], "Re");
 298                    if (dststr) {
 299                        dststr = strchr(opcode_reginfo[def_opcode], 'e');
 300                    } else {
 301                        dststr = strstr(opcode_wregs[def_opcode], "Ry");
 302                        if (dststr) {
 303                            dststr = strchr(opcode_reginfo[def_opcode], 'y');
 304                        } else {
 305                            g_assert_not_reached();
 306                        }
 307                    }
 308                }
 309            }
 310            g_assert(dststr != NULL);
 311
 312            /* Now patch up the consumer with the register number */
 313            dst_idx = dststr - opcode_reginfo[def_opcode];
 314            packet->insn[i].regno[use_regidx] =
 315                packet->insn[def_idx].regno[dst_idx];
 316            /*
 317             * We need to remember who produces this value to later
 318             * check if it was dynamically cancelled
 319             */
 320            packet->insn[i].new_value_producer_slot =
 321                packet->insn[def_idx].slot;
 322        }
 323    }
 324}
 325
 326/* Split CJ into a compare and a jump */
 327static void decode_split_cmpjump(Packet *pkt)
 328{
 329    int last, i;
 330    int numinsns = pkt->num_insns;
 331
 332    /*
 333     * First, split all compare-jumps.
 334     * The compare is sent to the end as a new instruction.
 335     * Do it this way so we don't reorder dual jumps. Those need to stay in
 336     * original order.
 337     */
 338    for (i = 0; i < numinsns; i++) {
 339        /* It's a cmp-jump */
 340        if (GET_ATTRIB(pkt->insn[i].opcode, A_NEWCMPJUMP)) {
 341            last = pkt->num_insns;
 342            pkt->insn[last] = pkt->insn[i];    /* copy the instruction */
 343            pkt->insn[last].part1 = 1;    /* last instruction does the CMP */
 344            pkt->insn[i].part1 = 0;    /* existing instruction does the JUMP */
 345            pkt->num_insns++;
 346        }
 347    }
 348
 349    /* Now re-shuffle all the compares back to the beginning */
 350    for (i = 0; i < pkt->num_insns; i++) {
 351        if (pkt->insn[i].part1) {
 352            decode_send_insn_to(pkt, i, 0);
 353        }
 354    }
 355}
 356
 357static inline int decode_opcode_can_jump(int opcode)
 358{
 359    if ((GET_ATTRIB(opcode, A_JUMP)) ||
 360        (GET_ATTRIB(opcode, A_CALL)) ||
 361        (opcode == J2_trap0) ||
 362        (opcode == J2_pause)) {
 363        /* Exception to A_JUMP attribute */
 364        if (opcode == J4_hintjumpr) {
 365            return 0;
 366        }
 367        return 1;
 368    }
 369
 370    return 0;
 371}
 372
 373static inline int decode_opcode_ends_loop(int opcode)
 374{
 375    return GET_ATTRIB(opcode, A_HWLOOP0_END) ||
 376           GET_ATTRIB(opcode, A_HWLOOP1_END);
 377}
 378
 379/* Set the is_* fields in each instruction */
 380static void decode_set_insn_attr_fields(Packet *pkt)
 381{
 382    int i;
 383    int numinsns = pkt->num_insns;
 384    uint16_t opcode;
 385
 386    pkt->pkt_has_cof = 0;
 387    pkt->pkt_has_endloop = 0;
 388    pkt->pkt_has_dczeroa = 0;
 389
 390    for (i = 0; i < numinsns; i++) {
 391        opcode = pkt->insn[i].opcode;
 392        if (pkt->insn[i].part1) {
 393            continue;    /* Skip compare of cmp-jumps */
 394        }
 395
 396        if (GET_ATTRIB(opcode, A_DCZEROA)) {
 397            pkt->pkt_has_dczeroa = 1;
 398        }
 399
 400        if (GET_ATTRIB(opcode, A_STORE)) {
 401            if (pkt->insn[i].slot == 0) {
 402                pkt->pkt_has_store_s0 = 1;
 403            } else {
 404                pkt->pkt_has_store_s1 = 1;
 405            }
 406        }
 407
 408        pkt->pkt_has_cof |= decode_opcode_can_jump(opcode);
 409
 410        pkt->insn[i].is_endloop = decode_opcode_ends_loop(opcode);
 411
 412        pkt->pkt_has_endloop |= pkt->insn[i].is_endloop;
 413
 414        pkt->pkt_has_cof |= pkt->pkt_has_endloop;
 415    }
 416}
 417
 418/*
 419 * Shuffle for execution
 420 * Move stores to end (in same order as encoding)
 421 * Move compares to beginning (for use by .new insns)
 422 */
 423static void decode_shuffle_for_execution(Packet *packet)
 424{
 425    int changed = 0;
 426    int i;
 427    int flag;    /* flag means we've seen a non-memory instruction */
 428    int n_mems;
 429    int last_insn = packet->num_insns - 1;
 430
 431    /*
 432     * Skip end loops, somehow an end loop is getting in and messing
 433     * up the order
 434     */
 435    if (decode_opcode_ends_loop(packet->insn[last_insn].opcode)) {
 436        last_insn--;
 437    }
 438
 439    do {
 440        changed = 0;
 441        /*
 442         * Stores go last, must not reorder.
 443         * Cannot shuffle stores past loads, either.
 444         * Iterate backwards.  If we see a non-memory instruction,
 445         * then a store, shuffle the store to the front.  Don't shuffle
 446         * stores wrt each other or a load.
 447         */
 448        for (flag = n_mems = 0, i = last_insn; i >= 0; i--) {
 449            int opcode = packet->insn[i].opcode;
 450
 451            if (flag && GET_ATTRIB(opcode, A_STORE)) {
 452                decode_send_insn_to(packet, i, last_insn - n_mems);
 453                n_mems++;
 454                changed = 1;
 455            } else if (GET_ATTRIB(opcode, A_STORE)) {
 456                n_mems++;
 457            } else if (GET_ATTRIB(opcode, A_LOAD)) {
 458                /*
 459                 * Don't set flag, since we don't want to shuffle a
 460                 * store past a load
 461                 */
 462                n_mems++;
 463            } else if (GET_ATTRIB(opcode, A_DOTNEWVALUE)) {
 464                /*
 465                 * Don't set flag, since we don't want to shuffle past
 466                 * a .new value
 467                 */
 468            } else {
 469                flag = 1;
 470            }
 471        }
 472
 473        if (changed) {
 474            continue;
 475        }
 476        /* Compares go first, may be reordered wrt each other */
 477        for (flag = 0, i = 0; i < last_insn + 1; i++) {
 478            int opcode = packet->insn[i].opcode;
 479
 480            if ((strstr(opcode_wregs[opcode], "Pd4") ||
 481                 strstr(opcode_wregs[opcode], "Pe4")) &&
 482                GET_ATTRIB(opcode, A_STORE) == 0) {
 483                /* This should be a compare (not a store conditional) */
 484                if (flag) {
 485                    decode_send_insn_to(packet, i, 0);
 486                    changed = 1;
 487                    continue;
 488                }
 489            } else if (GET_ATTRIB(opcode, A_IMPLICIT_WRITES_P3) &&
 490                       !decode_opcode_ends_loop(packet->insn[i].opcode)) {
 491                /*
 492                 * spNloop instruction
 493                 * Don't reorder endloops; they are not valid for .new uses,
 494                 * and we want to match HW
 495                 */
 496                if (flag) {
 497                    decode_send_insn_to(packet, i, 0);
 498                    changed = 1;
 499                    continue;
 500                }
 501            } else if (GET_ATTRIB(opcode, A_IMPLICIT_WRITES_P0) &&
 502                       !GET_ATTRIB(opcode, A_NEWCMPJUMP)) {
 503                if (flag) {
 504                    decode_send_insn_to(packet, i, 0);
 505                    changed = 1;
 506                    continue;
 507                }
 508            } else {
 509                flag = 1;
 510            }
 511        }
 512        if (changed) {
 513            continue;
 514        }
 515    } while (changed);
 516
 517    /*
 518     * If we have a .new register compare/branch, move that to the very
 519     * very end, past stores
 520     */
 521    for (i = 0; i < last_insn; i++) {
 522        if (GET_ATTRIB(packet->insn[i].opcode, A_DOTNEWVALUE)) {
 523            decode_send_insn_to(packet, i, last_insn);
 524            break;
 525        }
 526    }
 527}
 528
 529static void
 530apply_extender(Packet *pkt, int i, uint32_t extender)
 531{
 532    int immed_num;
 533    uint32_t base_immed;
 534
 535    immed_num = opcode_which_immediate_is_extended(pkt->insn[i].opcode);
 536    base_immed = pkt->insn[i].immed[immed_num];
 537
 538    pkt->insn[i].immed[immed_num] = extender | fZXTN(6, 32, base_immed);
 539}
 540
 541static void decode_apply_extenders(Packet *packet)
 542{
 543    int i;
 544    for (i = 0; i < packet->num_insns; i++) {
 545        if (GET_ATTRIB(packet->insn[i].opcode, A_IT_EXTENDER)) {
 546            packet->insn[i + 1].extension_valid = 1;
 547            apply_extender(packet, i + 1, packet->insn[i].immed[0]);
 548        }
 549    }
 550}
 551
 552static void decode_remove_extenders(Packet *packet)
 553{
 554    int i, j;
 555    for (i = 0; i < packet->num_insns; i++) {
 556        if (GET_ATTRIB(packet->insn[i].opcode, A_IT_EXTENDER)) {
 557            /* Remove this one by moving the remaining instructions down */
 558            for (j = i;
 559                (j < packet->num_insns - 1) && (j < INSTRUCTIONS_MAX - 1);
 560                j++) {
 561                packet->insn[j] = packet->insn[j + 1];
 562            }
 563            packet->num_insns--;
 564        }
 565    }
 566}
 567
 568static SlotMask get_valid_slots(const Packet *pkt, unsigned int slot)
 569{
 570    return find_iclass_slots(pkt->insn[slot].opcode,
 571                             pkt->insn[slot].iclass);
 572}
 573
 574#define DECODE_NEW_TABLE(TAG, SIZE, WHATNOT)     /* NOTHING */
 575#define TABLE_LINK(TABLE)                        /* NOTHING */
 576#define TERMINAL(TAG, ENC)                       /* NOTHING */
 577#define SUBINSNS(TAG, CLASSA, CLASSB, ENC)       /* NOTHING */
 578#define EXTSPACE(TAG, ENC)                       /* NOTHING */
 579#define INVALID()                                /* NOTHING */
 580#define DECODE_END_TABLE(...)                    /* NOTHING */
 581#define DECODE_MATCH_INFO(...)                   /* NOTHING */
 582#define DECODE_LEGACY_MATCH_INFO(...)            /* NOTHING */
 583
 584#define DECODE_REG(REGNO, WIDTH, STARTBIT) \
 585    insn->regno[REGNO] = ((encoding >> STARTBIT) & ((1 << WIDTH) - 1));
 586
 587#define DECODE_IMPL_REG(REGNO, VAL) \
 588    insn->regno[REGNO] = VAL;
 589
 590#define DECODE_IMM(IMMNO, WIDTH, STARTBIT, VALSTART) \
 591    insn->immed[IMMNO] |= (((encoding >> STARTBIT) & ((1 << WIDTH) - 1))) << \
 592                          (VALSTART);
 593
 594#define DECODE_IMM_SXT(IMMNO, WIDTH) \
 595    insn->immed[IMMNO] = ((((int32_t)insn->immed[IMMNO]) << (32 - WIDTH)) >> \
 596                          (32 - WIDTH));
 597
 598#define DECODE_IMM_NEG(IMMNO, WIDTH) \
 599    insn->immed[IMMNO] = -insn->immed[IMMNO];
 600
 601#define DECODE_IMM_SHIFT(IMMNO, SHAMT)                                 \
 602    if ((!insn->extension_valid) || \
 603        (insn->which_extended != IMMNO)) { \
 604        insn->immed[IMMNO] <<= SHAMT; \
 605    }
 606
 607#define DECODE_OPINFO(TAG, BEH) \
 608    case TAG: \
 609        { BEH  } \
 610        break; \
 611
 612/*
 613 * Fill in the operands of the instruction
 614 * dectree_generated.h.inc has a DECODE_OPINFO entry for each opcode
 615 * For example,
 616 *     DECODE_OPINFO(A2_addi,
 617 *          DECODE_REG(0,5,0)
 618 *          DECODE_REG(1,5,16)
 619 *          DECODE_IMM(0,7,21,9)
 620 *          DECODE_IMM(0,9,5,0)
 621 *          DECODE_IMM_SXT(0,16)
 622 * with the macros defined above, we'll fill in a switch statement
 623 * where each case is an opcode tag.
 624 */
 625static void
 626decode_op(Insn *insn, Opcode tag, uint32_t encoding)
 627{
 628    insn->immed[0] = 0;
 629    insn->immed[1] = 0;
 630    insn->opcode = tag;
 631    if (insn->extension_valid) {
 632        insn->which_extended = opcode_which_immediate_is_extended(tag);
 633    }
 634
 635    switch (tag) {
 636#include "dectree_generated.h.inc"
 637    default:
 638        break;
 639    }
 640
 641    insn->generate = opcode_genptr[tag];
 642
 643    insn->iclass = iclass_bits(encoding);
 644}
 645
 646#undef DECODE_REG
 647#undef DECODE_IMPL_REG
 648#undef DECODE_IMM
 649#undef DECODE_IMM_SHIFT
 650#undef DECODE_OPINFO
 651#undef DECODE_MATCH_INFO
 652#undef DECODE_LEGACY_MATCH_INFO
 653#undef DECODE_END_TABLE
 654#undef INVALID
 655#undef TERMINAL
 656#undef SUBINSNS
 657#undef EXTSPACE
 658#undef TABLE_LINK
 659#undef DECODE_NEW_TABLE
 660#undef DECODE_SEPARATOR_BITS
 661
 662static unsigned int
 663decode_subinsn_tablewalk(Insn *insn, const DectreeTable *table,
 664                         uint32_t encoding)
 665{
 666    unsigned int i;
 667    Opcode opc;
 668    if (table->lookup_function) {
 669        i = table->lookup_function(table->startbit, table->width, encoding);
 670    } else {
 671        i = extract32(encoding, table->startbit, table->width);
 672    }
 673    if (table->table[i].type == DECTREE_TABLE_LINK) {
 674        return decode_subinsn_tablewalk(insn, table->table[i].table_link,
 675                                        encoding);
 676    } else if (table->table[i].type == DECTREE_TERMINAL) {
 677        opc = table->table[i].opcode;
 678        if ((encoding & decode_itable[opc].mask) != decode_itable[opc].match) {
 679            return 0;
 680        }
 681        decode_op(insn, opc, encoding);
 682        return 1;
 683    } else {
 684        return 0;
 685    }
 686}
 687
 688static unsigned int get_insn_a(uint32_t encoding)
 689{
 690    return extract32(encoding, 0, 13);
 691}
 692
 693static unsigned int get_insn_b(uint32_t encoding)
 694{
 695    return extract32(encoding, 16, 13);
 696}
 697
 698static unsigned int
 699decode_insns_tablewalk(Insn *insn, const DectreeTable *table,
 700                       uint32_t encoding)
 701{
 702    unsigned int i;
 703    unsigned int a, b;
 704    Opcode opc;
 705    if (table->lookup_function) {
 706        i = table->lookup_function(table->startbit, table->width, encoding);
 707    } else {
 708        i = extract32(encoding, table->startbit, table->width);
 709    }
 710    if (table->table[i].type == DECTREE_TABLE_LINK) {
 711        return decode_insns_tablewalk(insn, table->table[i].table_link,
 712                                      encoding);
 713    } else if (table->table[i].type == DECTREE_SUBINSNS) {
 714        a = get_insn_a(encoding);
 715        b = get_insn_b(encoding);
 716        b = decode_subinsn_tablewalk(insn, table->table[i].table_link_b, b);
 717        a = decode_subinsn_tablewalk(insn + 1, table->table[i].table_link, a);
 718        if ((a == 0) || (b == 0)) {
 719            return 0;
 720        }
 721        return 2;
 722    } else if (table->table[i].type == DECTREE_TERMINAL) {
 723        opc = table->table[i].opcode;
 724        if ((encoding & decode_itable[opc].mask) != decode_itable[opc].match) {
 725            if ((encoding & decode_legacy_itable[opc].mask) !=
 726                decode_legacy_itable[opc].match) {
 727                return 0;
 728            }
 729        }
 730        decode_op(insn, opc, encoding);
 731        return 1;
 732    } else {
 733        return 0;
 734    }
 735}
 736
 737static unsigned int
 738decode_insns(Insn *insn, uint32_t encoding)
 739{
 740    const DectreeTable *table;
 741    if (parse_bits(encoding) != 0) {
 742        /* Start with PP table - 32 bit instructions */
 743        table = &dectree_table_DECODE_ROOT_32;
 744    } else {
 745        /* start with EE table - duplex instructions */
 746        table = &dectree_table_DECODE_ROOT_EE;
 747    }
 748    return decode_insns_tablewalk(insn, table, encoding);
 749}
 750
 751static void decode_add_endloop_insn(Insn *insn, int loopnum)
 752{
 753    if (loopnum == 10) {
 754        insn->opcode = J2_endloop01;
 755        insn->generate = opcode_genptr[J2_endloop01];
 756    } else if (loopnum == 1) {
 757        insn->opcode = J2_endloop1;
 758        insn->generate = opcode_genptr[J2_endloop1];
 759    } else if (loopnum == 0) {
 760        insn->opcode = J2_endloop0;
 761        insn->generate = opcode_genptr[J2_endloop0];
 762    } else {
 763        g_assert_not_reached();
 764    }
 765}
 766
 767static inline int decode_parsebits_is_loopend(uint32_t encoding32)
 768{
 769    uint32_t bits = parse_bits(encoding32);
 770    return bits == 0x2;
 771}
 772
 773static void
 774decode_set_slot_number(Packet *pkt)
 775{
 776    int slot;
 777    int i;
 778    int hit_mem_insn = 0;
 779    int hit_duplex = 0;
 780
 781    /*
 782     * The slots are encoded in reverse order
 783     * For each instruction, count down until you find a suitable slot
 784     */
 785    for (i = 0, slot = 3; i < pkt->num_insns; i++) {
 786        SlotMask valid_slots = get_valid_slots(pkt, i);
 787
 788        while (!(valid_slots & (1 << slot))) {
 789            slot--;
 790        }
 791        pkt->insn[i].slot = slot;
 792        if (slot) {
 793            /* I've assigned the slot, now decrement it for the next insn */
 794            slot--;
 795        }
 796    }
 797
 798    /* Fix the exceptions - mem insns to slot 0,1 */
 799    for (i = pkt->num_insns - 1; i >= 0; i--) {
 800        /* First memory instruction always goes to slot 0 */
 801        if ((GET_ATTRIB(pkt->insn[i].opcode, A_MEMLIKE) ||
 802             GET_ATTRIB(pkt->insn[i].opcode, A_MEMLIKE_PACKET_RULES)) &&
 803            !hit_mem_insn) {
 804            hit_mem_insn = 1;
 805            pkt->insn[i].slot = 0;
 806            continue;
 807        }
 808
 809        /* Next memory instruction always goes to slot 1 */
 810        if ((GET_ATTRIB(pkt->insn[i].opcode, A_MEMLIKE) ||
 811             GET_ATTRIB(pkt->insn[i].opcode, A_MEMLIKE_PACKET_RULES)) &&
 812            hit_mem_insn) {
 813            pkt->insn[i].slot = 1;
 814        }
 815    }
 816
 817    /* Fix the exceptions - duplex always slot 0,1 */
 818    for (i = pkt->num_insns - 1; i >= 0; i--) {
 819        /* First subinsn always goes to slot 0 */
 820        if (GET_ATTRIB(pkt->insn[i].opcode, A_SUBINSN) && !hit_duplex) {
 821            hit_duplex = 1;
 822            pkt->insn[i].slot = 0;
 823            continue;
 824        }
 825
 826        /* Next subinsn always goes to slot 1 */
 827        if (GET_ATTRIB(pkt->insn[i].opcode, A_SUBINSN) && hit_duplex) {
 828            pkt->insn[i].slot = 1;
 829        }
 830    }
 831
 832    /* Fix the exceptions - slot 1 is never empty, always aligns to slot 0 */
 833    int slot0_found = 0;
 834    int slot1_found = 0;
 835    int slot1_iidx = 0;
 836    for (i = pkt->num_insns - 1; i >= 0; i--) {
 837        /* Is slot0 used? */
 838        if (pkt->insn[i].slot == 0) {
 839            int is_endloop = (pkt->insn[i].opcode == J2_endloop01);
 840            is_endloop |= (pkt->insn[i].opcode == J2_endloop0);
 841            is_endloop |= (pkt->insn[i].opcode == J2_endloop1);
 842
 843            /*
 844             * Make sure it's not endloop since, we're overloading
 845             * slot0 for endloop
 846             */
 847            if (!is_endloop) {
 848                slot0_found = 1;
 849            }
 850        }
 851        /* Is slot1 used? */
 852        if (pkt->insn[i].slot == 1) {
 853            slot1_found = 1;
 854            slot1_iidx = i;
 855        }
 856    }
 857    /* Is slot0 empty and slot1 used? */
 858    if ((slot0_found == 0) && (slot1_found == 1)) {
 859        /* Then push it to slot0 */
 860        pkt->insn[slot1_iidx].slot = 0;
 861    }
 862}
 863
 864/*
 865 * decode_packet
 866 * Decodes packet with given words
 867 * Returns 0 on insufficient words,
 868 * or number of words used on success
 869 */
 870
 871int decode_packet(int max_words, const uint32_t *words, Packet *pkt,
 872                  bool disas_only)
 873{
 874    int num_insns = 0;
 875    int words_read = 0;
 876    int end_of_packet = 0;
 877    int new_insns = 0;
 878    uint32_t encoding32;
 879
 880    /* Initialize */
 881    memset(pkt, 0, sizeof(*pkt));
 882    /* Try to build packet */
 883    while (!end_of_packet && (words_read < max_words)) {
 884        encoding32 = words[words_read];
 885        end_of_packet = is_packet_end(encoding32);
 886        new_insns = decode_insns(&pkt->insn[num_insns], encoding32);
 887        g_assert(new_insns > 0);
 888        /*
 889         * If we saw an extender, mark next word extended so immediate
 890         * decode works
 891         */
 892        if (pkt->insn[num_insns].opcode == A4_ext) {
 893            pkt->insn[num_insns + 1].extension_valid = 1;
 894        }
 895        num_insns += new_insns;
 896        words_read++;
 897    }
 898
 899    pkt->num_insns = num_insns;
 900    if (!end_of_packet) {
 901        /* Ran out of words! */
 902        return 0;
 903    }
 904    pkt->encod_pkt_size_in_bytes = words_read * 4;
 905
 906    /*
 907     * Check for :endloop in the parse bits
 908     * Section 10.6 of the Programmer's Reference describes the encoding
 909     *     The end of hardware loop 0 can be encoded with 2 words
 910     *     The end of hardware loop 1 needs 3 words
 911     */
 912    if ((words_read == 2) && (decode_parsebits_is_loopend(words[0]))) {
 913        decode_add_endloop_insn(&pkt->insn[pkt->num_insns++], 0);
 914    }
 915    if (words_read >= 3) {
 916        uint32_t has_loop0, has_loop1;
 917        has_loop0 = decode_parsebits_is_loopend(words[0]);
 918        has_loop1 = decode_parsebits_is_loopend(words[1]);
 919        if (has_loop0 && has_loop1) {
 920            decode_add_endloop_insn(&pkt->insn[pkt->num_insns++], 10);
 921        } else if (has_loop1) {
 922            decode_add_endloop_insn(&pkt->insn[pkt->num_insns++], 1);
 923        } else if (has_loop0) {
 924            decode_add_endloop_insn(&pkt->insn[pkt->num_insns++], 0);
 925        }
 926    }
 927
 928    decode_apply_extenders(pkt);
 929    if (!disas_only) {
 930        decode_remove_extenders(pkt);
 931    }
 932    decode_set_slot_number(pkt);
 933    decode_fill_newvalue_regno(pkt);
 934
 935    if (!disas_only) {
 936        decode_shuffle_for_execution(pkt);
 937        decode_split_cmpjump(pkt);
 938        decode_set_insn_attr_fields(pkt);
 939    }
 940
 941    return words_read;
 942}
 943
 944/* Used for "-d in_asm" logging */
 945int disassemble_hexagon(uint32_t *words, int nwords, bfd_vma pc,
 946                        GString *buf)
 947{
 948    Packet pkt;
 949
 950    if (decode_packet(nwords, words, &pkt, true) > 0) {
 951        snprint_a_pkt_disas(buf, &pkt, words, pc);
 952        return pkt.encod_pkt_size_in_bytes;
 953    } else {
 954        g_string_assign(buf, "<invalid>");
 955        return 0;
 956    }
 957}
 958