HL.SWP

assembly

[
  "hl.swp SrcD, SrcD1, [SrcL, SrcR<{.sw,.uw,.neg}><<2]"
]

block

[]

catalog_indices

[
  300
]

catalog_records

[
  {
    "agu": {
      "action": "StorePair",
      "address_kind": "Register",
      "offset_scale": 2,
      "prefetch_returns_address": false,
      "signed_load": false,
      "size_bytes": 4,
      "update_mode": "None"
    },
    "asm": "hl.swp SrcD, SrcD1, [SrcL, SrcR<{.sw,.uw,.neg}><<2]",
    "constraints": [],
    "encoding": [
      {
        "index": 0,
        "mask": "0x00007ffff83f",
        "match": "0x00002049001e",
        "width_bits": 48
      }
    ],
    "encoding_kind": "HL48",
    "fields": [
      {
        "name": "SrcD",
        "pieces": [
          {
            "instruction_lsb": 43,
            "value_lsb": 0,
            "width": 5
          }
        ],
        "signedness": "encoding-defined",
        "width": 5
      },
      {
        "name": "SrcD1",
        "pieces": [
          {
            "instruction_lsb": 6,
            "value_lsb": 0,
            "width": 5
          }
        ],
        "signedness": "encoding-defined",
        "width": 5
      },
      {
        "name": "SrcL",
        "pieces": [
          {
            "instruction_lsb": 31,
            "value_lsb": 0,
            "width": 5
          }
        ],
        "signedness": "encoding-defined",
        "width": 5
      },
      {
        "name": "SrcR",
        "pieces": [
          {
            "instruction_lsb": 36,
            "value_lsb": 0,
            "width": 5
          }
        ],
        "signedness": "encoding-defined",
        "width": 5
      },
      {
        "name": "SrcRType",
        "pieces": [
          {
            "instruction_lsb": 41,
            "value_lsb": 0,
            "width": 2
          }
        ],
        "signedness": "encoding-defined",
        "width": 2
      }
    ],
    "form_id": "hl_swp_48_d0efe96e09f0",
    "length_bits": 48,
    "mnemonic": "HL.SWP",
    "semantic_family": "AGU",
    "semantic_group": "STA/PAIR",
    "semantic_handler": "ExecuteScalarStorePair",
    "semantic_summary": "HL.SWP snapshots its scalar sources, forms its encoded address, and stores two adjacent aligned little-endian 4-byte values.",
    "status": "accepted"
  }
]

classification

[
  "agu"
]

contract

{
  "block_composition": [
    "none"
  ],
  "canonical_assembly": [
    "hl.swp SrcD, SrcD1, [SrcL, SrcR<{.sw,.uw,.neg}><<2]"
  ],
  "defaults": [
    "Every displayed operand field is encoded explicitly; encoded zero is a value and never denotes omission.",
    "SrcRType=0 leaves SrcR unchanged, SrcRType=1 sign-extends SrcR[31:0], SrcRType=2 zero-extends SrcR[31:0], and SrcRType=3 negates the full PTO_XLEN value. Encoded shamt zero performs no shift."
  ],
  "encoding_class": "standalone-encoded",
  "examples": [
    "hl.swp SrcD, SrcD1, [SrcL, SrcR<{.sw,.uw,.neg}><<2]"
  ],
  "exceptions": [
    "A fixed-bit mismatch, reserved field value, or unavailable selected T/U source raises Fault_IllegalInstruction before instruction effects.",
    "A misaligned 4-byte address raises Fault_DataAlignment before translation or permission. A later permission or bounded-memory failure raises Fault_DataPage at the original address.",
    "A fault emits no successful memory event, performs no partial memory or destination effect, preserves pending writeback, and leaves TPC at the faulting instruction.",
    "Recovery performs a full reissue: every address, source snapshot, preflight, memory operation, and destination is recomputed with no retained progress."
  ],
  "field_contracts": {},
  "field_zero_meanings": {
    "SrcD": "Encoded zero reads the architectural zero GPR.",
    "SrcD1": "Encoded zero reads the architectural zero GPR.",
    "SrcL": "Encoded zero reads the architectural zero GPR.",
    "SrcR": "Encoded zero reads the architectural zero GPR.",
    "SrcRType": "Encoded zero leaves the complete PTO_XLEN register-offset value unchanged."
  },
  "legality": [
    "Every encoded Reg5 source uses the complete domain: codes 0..23 select absolute GPRs, codes 24..27 select T#1..T#4, and codes 28..31 select U#1..U#4 without consumption.",
    "All four SrcRType values and all shamt values 0..31 are assigned; apply the modifier before the shift.",
    "Each memory address must be aligned to the 4-byte access size; a 4-byte access is the complete transfer unit."
  ],
  "memory_effects": [
    "Preflight both adjacent 4-byte addresses before either store; on success record two relaxed store events in address order.",
    "Successful overlapping stores invalidate an overlapping reservation only after complete pair preflight."
  ],
  "operands": [
    {
      "field": "SrcD",
      "role": "Reg5 first store-data source"
    },
    {
      "field": "SrcD1",
      "role": "Reg5 second store-data source"
    },
    {
      "field": "SrcL",
      "role": "Reg5 address-base source"
    },
    {
      "field": "SrcR",
      "role": "Reg5 register-offset source"
    },
    {
      "field": "SrcRType",
      "role": "register-offset transformation selector"
    }
  ],
  "ordering": [
    "Snapshot all explicit and implicit scalar sources before destination or memory effects; duplicate and source/destination aliases observe pre-instruction values.",
    "Preflight both addresses, commit the two relaxed 4-byte operations in address order, publish ordered results if any, then advance TPC."
  ],
  "standalone_opcode": true,
  "state_effects": [
    "Form offset = LSL(Modify(SrcR, SrcRType), 2) and add it modulo 2^PTO_XLEN to the SrcL base.",
    "The pair addresses are address and address plus 4; the instruction performs no base writeback.",
    "Snapshot every store-data source before any memory effect or destination publication.",
    "Successful execution advances TPC by 6 bytes; a rejected or faulting attempt does not retire."
  ]
}

depends_on

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

id

PTO-SCALAR-HL-SWP

mnemonic

HL.SWP

summary

HL.SWP snapshots its scalar sources, forms its encoded address, and stores two adjacent aligned little-endian 4-byte values.

surface

scalar

{
  "classification": [
    "agu"
  ],
  "documentation": "docs/scalar/agu/HL.SWP.md",
  "id": "PTO-SCALAR-HL-SWP",
  "instruction_contract": {
    "artifact": "spec/evidence/instruction-contract-closure.json",
    "mnemonic": "HL.SWP",
    "ndf_clause": "PTO-INST-SCALAR-HL-SWP"
  },
  "mnemonic": "HL.SWP",
  "readiness_subjects": [
    "ADR-0029",
    "ADR-0059"
  ],
  "semantic_tests": [
    "PTO-AVS-AGU-HL-SWP-ALIAS-001",
    "PTO-AVS-AGU-HL-SWP-BOUND-001",
    "PTO-AVS-AGU-HL-SWP-EXEC-001",
    "PTO-AVS-AGU-HL-SWP-FAULT-001"
  ],
  "source": "asl/scalar/agu/HL.SWP.asl",
  "surface": "scalar",
  "tests": [
    "PTO-AVS-AGU-HL-SWP-ALIAS-001",
    "PTO-AVS-AGU-HL-SWP-BOUND-001",
    "PTO-AVS-AGU-HL-SWP-EXEC-001",
    "PTO-AVS-AGU-HL-SWP-FAULT-001",
    "PTO-AVS-SCALAR-HL-SWP-DECODE-001"
  ]
}