HL.SETC.EQI

assembly

[
  "hl.setc.eqi SrcL, simm"
]

block

[]

catalog_indices

[
  260
]

catalog_records

[
  {
    "asm": "hl.setc.eqi SrcL, simm",
    "constraints": [],
    "encoding": [
      {
        "index": 0,
        "mask": "0x0000707f000f",
        "match": "0x00000075000e",
        "width_bits": 48
      }
    ],
    "encoding_kind": "HL48",
    "fields": [
      {
        "name": "SrcL",
        "pieces": [
          {
            "instruction_lsb": 31,
            "value_lsb": 0,
            "width": 5
          }
        ],
        "signedness": "encoding-defined",
        "width": 5
      },
      {
        "name": "shamt",
        "pieces": [
          {
            "instruction_lsb": 23,
            "value_lsb": 0,
            "width": 5
          }
        ],
        "signedness": "encoding-defined",
        "width": 5
      },
      {
        "name": "simm24",
        "pieces": [
          {
            "instruction_lsb": 36,
            "value_lsb": 0,
            "width": 12
          },
          {
            "instruction_lsb": 4,
            "value_lsb": 12,
            "width": 12
          }
        ],
        "signedness": "signed",
        "width": 24
      }
    ],
    "form_id": "hl_setc_eqi_48_0fe891fb0890",
    "length_bits": 48,
    "mnemonic": "HL.SETC.EQI",
    "semantic_family": "BRU",
    "semantic_group": "BRU",
    "semantic_handler": "ExecuteSetCommit",
    "semantic_summary": "HL.SETC.EQI - Compare scalar operands and update the bundle commit condition.",
    "status": "accepted"
  }
]

classification

[
  "bru"
]

contract

{
  "block_composition": [
    "Applicable only in the body of an active block whose BARG.TYPE is Conditional. Across the entire SETC condition-setting family, at most one occurrence may complete successfully in that block."
  ],
  "canonical_assembly": [
    "hl.setc.eqi SrcL, simm"
  ],
  "defaults": [
    "The selected assembly form determines which fields are present; every present field carries its encoded value and no encoded zero means omission."
  ],
  "encoding_class": "standalone-encoded",
  "examples": [
    "hl.setc.eqi SrcL, simm"
  ],
  "exceptions": [
    "Wrong block placement or a second successful SETC condition setter raises Illegal Block Exception before scalar source readiness or any architectural or pending-block effect.",
    "A fixed-bit mismatch or unavailable selected relative source raises Fault_IllegalInstruction before commit state, BARG, queues, or TPC effects."
  ],
  "field_contracts": {},
  "field_zero_meanings": {
    "SrcL": "Encoded zero names the architectural zero GPR.",
    "shamt": "Encoded zero performs no shift.",
    "simm24": "Encoded zero supplies numeric zero for the 24-bit signed immediate or displacement."
  },
  "legality": [
    "All SETC condition setters share one block-private successful-occurrence marker; a failed first occurrence does not consume it."
  ],
  "memory_effects": [
    "none"
  ],
  "operands": [
    {
      "field": "SrcL",
      "role": "left absolute GPR source"
    },
    {
      "field": "shamt",
      "role": "shift amount"
    },
    {
      "field": "simm24",
      "role": "24-bit signed immediate or displacement"
    }
  ],
  "ordering": [
    "Check Conditional-block applicability and the shared occurrence marker before scalar source readiness or reads.",
    "Snapshot all sources, compute the canonical zero-or-one condition, then atomically update the commit argument, BARG.TAKEN, and the occurrence marker."
  ],
  "standalone_opcode": true,
  "state_effects": [
    "Compute HL.SETC.EQI's local comparison or logical condition from source snapshots and canonicalize it to zero or one.",
    "Atomically write that value to the commit argument and BARG.TAKEN, then mark the block condition as set. Preserve BARG.BPC, BARG.BPCN, BARG.BlockType, and BARG.TYPE.",
    "No memory, reservation, descriptor, numeric-status, or destination-register effect occurs. Successful execution advances TPC by the encoded instruction length."
  ]
}

depends_on

[
  "PTO-BLOCK-MODEL-SCHEMA-PROFILE-ENCODING"
]

id

PTO-SCALAR-HL-SETC-EQI

mnemonic

HL.SETC.EQI

summary

HL.SETC.EQI - Compare scalar operands and update the bundle commit condition.

surface

scalar

{
  "classification": [
    "bru"
  ],
  "documentation": "docs/scalar/bru/HL.SETC.EQI.md",
  "id": "PTO-SCALAR-HL-SETC-EQI",
  "instruction_contract": {
    "artifact": "spec/evidence/instruction-contract-closure.json",
    "mnemonic": "HL.SETC.EQI",
    "ndf_clause": "PTO-INST-SCALAR-HL-SETC-EQI"
  },
  "mnemonic": "HL.SETC.EQI",
  "readiness_subjects": [
    "ADR-0027",
    "ADR-0059",
    "ADR-0084"
  ],
  "semantic_tests": [
    "PTO-AVS-BRU-HL-SETC-EQI-BOUND-001",
    "PTO-AVS-BRU-HL-SETC-EQI-EXEC-001",
    "PTO-AVS-SCALAR-HL-SETC-EQI-PLACE-002"
  ],
  "source": "asl/scalar/bru/HL.SETC.EQI.asl",
  "surface": "scalar",
  "tests": [
    "PTO-AVS-BRU-HL-SETC-EQI-BOUND-001",
    "PTO-AVS-BRU-HL-SETC-EQI-EXEC-001",
    "PTO-AVS-SCALAR-HL-SETC-EQI-DECODE-001",
    "PTO-AVS-SCALAR-HL-SETC-EQI-PLACE-002"
  ]
}