Skip to main content

PTO-BLOCK-MODEL-DISPATCH-CELL-REARRANGEMENT-SCHEMA

PTO-BLOCK-MODEL-DISPATCH-CELL-REARRANGEMENT-SCHEMA

ASL pseudocode

The complete ASL owner is shown directly below.

// PTO-UNIT: {"id":"PTO-BLOCK-MODEL-DISPATCH-CELL-REARRANGEMENT-SCHEMA","surface":"block","classification":["model","dispatch","cell-rearrangement-schema"],"depends_on":["PTO-BLOCK-MODEL-DISPATCH-TILE-SCHEMA"]}
func ResolveBundleCellRearrangementDestination() => booleanbegin    var destination_binding: BundleTileBindingIndex = 0;    var destination_seen = FALSE;    var source: TileIndex = 0;    var source_seen = FALSE;    for binding = 0 to PTO_BUNDLE_TILE_BINDING_COUNT - 1 looplimit 16 do        if _BundleTileBindings[[binding]].valid then            if !destination_seen &&               _BundleTileBindings[[binding]].destination_valid then                destination_binding = binding as BundleTileBindingIndex;                destination_seen = TRUE;            end;            if !source_seen &&               _BundleTileBindings[[binding]].source0_valid then                source = BundleTileSourceIndex(                    binding as BundleTileBindingIndex, FALSE);                source_seen = TRUE;            elsif !source_seen &&                  _BundleTileBindings[[binding]].source1_valid then                source = BundleTileSourceIndex(                    binding as BundleTileBindingIndex, TRUE);                source_seen = TRUE;            end;        end;    end;    if !destination_seen || !source_seen ||       !TileCubeDescriptorLegal(_Tiles[[source]]) then        SetFault(Fault_TileLegality, ReadTPC());        return FALSE;    end;    let binding = _BundleTileBindings[[destination_binding]];    let source_tile = _Tiles[[source]];    let capacity_bytes = BundleLocalDestinationAllocationBytes(        destination_binding);    if !TileCubeDescriptorShapeLegal(capacity_bytes,           source_tile.valid_rows, source_tile.valid_columns,           source_tile.data_type, source_tile.layout) then        SetFault(Fault_TileAllocation, ReadTPC());        return FALSE;    end;    let hand = UInt(binding.destination_hand);    var resolved: TileIndex = 0;    var found = FALSE;    for offset = 0 to 15 looplimit 16 do        let raw_index = hand * 16 + offset;        if !found && !_Tiles[[raw_index]].allocated then            resolved = raw_index as TileIndex;            found = TRUE;        end;    end;    if !found || !LocalTileAllocationFitsExcept(           resolved, binding.pe_mask, capacity_bytes) then        SetFault(Fault_TileAllocation, ReadTPC());        return FALSE;    end;    let configured = ConfigureCubeTileForMask(        resolved, capacity_bytes, source_tile.valid_rows,        source_tile.valid_columns, source_tile.data_type,        source_tile.layout, TileLocation_Matrix, binding.pe_mask);    if !configured then        SetFault(Fault_TileAllocation, ReadTPC());        return FALSE;    end;    _BundleTileBindings[[destination_binding]].destination = resolved;    _BundleTileBindings[[destination_binding]].destination_allocated_by_bundle =        TRUE;    return TRUE;end;
pure func TileOperationUsesCellRearrangementSchema(    operation: integer {0..PTO_TILE_OPERATION_COUNT-1}) => booleanbegin    let decoded = TileOperationOfIndex(operation);    return decoded == TileOperation_TPERMUTE ||           decoded == TileOperation_TSHUF ||           decoded == TileOperation_TPACK ||           decoded == TileOperation_TUNPACK;end;
readonly func SelectedBundleCellRearrangementSchemaLegal(    operation: integer {0..PTO_TILE_OPERATION_COUNT-1}) => booleanbegin    if !TileOperationUsesCellRearrangementSchema(operation) then return TRUE; end;    if SelectedBundleTileMaskIsZero() then return TRUE; end;    let decoded = TileOperationOfIndex(operation);    if decoded == TileOperation_TPERMUTE then        if BundleTileBindingCount() != 2 || BundleSharedBindingCount() != 0 ||           _BundleScalarBindings[[0]].valid then return FALSE; end;        let first = _BundleTileBindings[[0]];        let second = _BundleTileBindings[[1]];        return !first.destination_valid && first.source0_valid &&               first.source1_valid && !first.last && second.destination_valid &&               !second.destination_allocated_by_bundle && second.source0_valid &&               !second.source1_valid && second.last &&               second.source0 != first.source0 &&               second.source0 != first.source1 &&               BundleTileDestinationSizeLegal(1);    end;    if BundleTileBindingCount() != 1 || BundleSharedBindingCount() != 0 ||       !_BundleScalarBindings[[0]].valid ||       _BundleScalarBindings[[0]].source1 != 0 ||       _BundleScalarBindings[[0]].source2 != 0 ||       _BundleScalarBindings[[0]].destination != 0 then        return FALSE;    end;    let binding = _BundleTileBindings[[0]];    if !binding.destination_valid || binding.destination_allocated_by_bundle ||       !BundleTileDestinationSizeLegal(0) || !binding.last then        return FALSE;    end;    if decoded == TileOperation_TUNPACK then        return binding.source0_valid && !binding.source1_valid;    end;    return binding.source0_valid && binding.source1_valid;end;

Architecture behavior

This internal model unit is documented through its normative ASL/NDF owners and validation evidence; it has no reader-guide migration target.

NDF clauses

Bodies come from owning ASL. Dragging or buttons change only this page-session view order.

No NDF clause is attached to this unit.

Evidence index

8 matching entries

Executable evidence2
  • Decoded cell-rearrangement bundles exercise normal control, mandatory and surplus B.IOR, raw control faults, zero-mask no-op, and removed selectors.
    1. surfaceBLOCK
    2. ownerPTO-BLOCK-MODEL-DISPATCH-CELL-REARRANGEMENT-SCHEMA
    3. categoryEXECUTION
    4. case001
    Show exact test source
    Sources and references
    Complete stable ID
    PTO-AVS-BLOCK-CELL-REARRANGE-DECODED-001
    Path
    tests/asl/block/model/dispatch/cell-rearrangement-schema/block-exec-cell-rearrangement-decoded-001.asl
    Kind / role
    execution
    Requirements
    PTO-INST-TILE-TPERMUTE, PTO-INST-TILE-TSHUF
    Pass condition
    The selected bundle either publishes the decoded result or reports the specified architectural fault before effects.
    SHA-256
    4991c63e3d0381992b52d28493920d050c24584b2ab3c3dd1c4cfced9032ff1f
    Open exact source ↗ for PTO-AVS-BLOCK-CELL-REARRANGE-DECODED-001
  • PTO-BLOCK-MODEL-DISPATCH-CELL-REARRANGEMENT-SCHEMA compiles as an independent normative unit
    1. surfaceBLOCK
    2. ownerPTO-BLOCK-MODEL-DISPATCH-CELL-REARRANGEMENT-SCHEMA
    3. categorySTATIC-INVARIANT
    4. case001
    Show exact test source
    Sources and references
    Complete stable ID
    PTO-AVS-BLOCK-MODEL-DISPATCH-CELL-REARR-SCHEMA-STATIC-001
    Path
    tests/asl/block/model/dispatch/cell-rearrangement-schema/block-static-cell-rearrangement-schema-contract-001.asl
    Kind / role
    static-invariant
    Pass condition
    the complete model and this unit's static invariant compile
    SHA-256
    0879005dd205d25e980c6e0e964c807f4ee1e100933b935d5d5d38207f4a89c2
    Open exact source ↗ for PTO-AVS-BLOCK-MODEL-DISPATCH-CELL-REARR-SCHEMA-STATIC-001
Commit-scoped evidence5
  • spec/evidence/release-traceability-readiness.json · closedPTO-EVIDENCE-RELEASE-TRACEABILITY
    Sources and references
    Complete stable ID
    PTO-EVIDENCE-RELEASE-TRACEABILITY
    Path
    spec/evidence/release-traceability-readiness.json
    Kind / role
    ASL/NDF/documentation/AVS traceability
    SHA-256
    c7327021d39dc67ac5564bc55073b3870a397d79ac8d9648284d56e33bc14a3e
    Open exact source ↗ for PTO-EVIDENCE-RELEASE-TRACEABILITY
  • spec/evidence/instruction-contract-closure.json · closedPTO-EVIDENCE-INSTRUCTION-CONTRACT-CLOSURE
    Sources and references
    Complete stable ID
    PTO-EVIDENCE-INSTRUCTION-CONTRACT-CLOSURE
    Path
    spec/evidence/instruction-contract-closure.json
    Kind / role
    mnemonic and encoding contract closure
    SHA-256
    3ef2bb62421c79dff8fa77a1c7983923b523244b8090812883ef81286ca8106a
    Open exact source ↗ for PTO-EVIDENCE-INSTRUCTION-CONTRACT-CLOSURE
  • spec/evidence/architecture-readiness.json · openPTO-EVIDENCE-ARCHITECTURE-READINESS
    Sources and references
    Complete stable ID
    PTO-EVIDENCE-ARCHITECTURE-READINESS
    Path
    spec/evidence/architecture-readiness.json
    Kind / role
    architecture maturity and blockers
    SHA-256
    4b0b85199101251bea744e0f3591cc31906909dc80d5ab651c417a936036a004
    Open exact source ↗ for PTO-EVIDENCE-ARCHITECTURE-READINESS
  • spec/evidence/release-gate-readiness.json · ready-for-exact-head-verificationPTO-EVIDENCE-RELEASE-GATE-READINESS
    Sources and references
    Complete stable ID
    PTO-EVIDENCE-RELEASE-GATE-READINESS
    Path
    spec/evidence/release-gate-readiness.json
    Kind / role
    exact-head gate readiness
    SHA-256
    a0f4d2b6920c08981ea55fd8ef820708a40d4feb5402c5150e8e9ab532d84ce0
    Open exact source ↗ for PTO-EVIDENCE-RELEASE-GATE-READINESS
  • spec/release-manifest.json · draftPTO-EVIDENCE-RELEASE-MANIFEST
    Sources and references
    Complete stable ID
    PTO-EVIDENCE-RELEASE-MANIFEST
    Path
    spec/release-manifest.json
    Kind / role
    release content and encoding fingerprints
    SHA-256
    1a64c109ed7a90351c41e2a418b3c0ebaf8ad975838986d2101385186b85c0d8
    Open exact source ↗ for PTO-EVIDENCE-RELEASE-MANIFEST
Decision history1
  • PTO ISA 0.58.4.1 to 0.58.5 compatibility boundary · accepted
    1. decision recordADR
    2. case0108

    Decision record

    Loading ADR-0108…

    Sources and references
    Complete stable ID
    ADR-0108
    Path
    docs/status/decisions/0108-0584-1-to-0585-compatibility.md
    Affected units
    PTO-ARCH-FEATURES-TILE-ALLOCATION, PTO-ARCH-MEMORY-MODEL-GLOBAL-MEMORY-ACCESS, PTO-ARCH-OVERVIEW-ENCODING-OWNERSHIP, PTO-BLOCK-B-IOS, PTO-BLOCK-B-IOT, PTO-BLOCK-BSTART-TLOAD, PTO-BLOCK-BSTART-TMATMUL, PTO-BLOCK-BSTART-TMATMUL-ACC, PTO-BLOCK-BSTART-TMATMUL-BIAS, PTO-BLOCK-BSTART-TMATMULMX, PTO-BLOCK-BSTART-TMATMULMX-ACC, PTO-BLOCK-BSTART-TMATMULMX-BIAS, PTO-BLOCK-BSTART-TMOV, PTO-BLOCK-BSTART-TSTORE, PTO-BLOCK-MODEL-DISPATCH-CELL-REARRANGEMENT-SCHEMA, PTO-BLOCK-MODEL-DISPATCH-COMMANDS, PTO-BLOCK-MODEL-DISPATCH-CUBE-TMATMUL, PTO-BLOCK-MODEL-DISPATCH-DESCRIPTOR-LEGALITY, PTO-BLOCK-MODEL-DISPATCH-DESTINATION-SHAPE, PTO-BLOCK-MODEL-DISPATCH-PARTIAL-SCHEMA, PTO-BLOCK-MODEL-DISPATCH-SHARED-CUBE-MATRIX, PTO-BLOCK-MODEL-DISPATCH-SHARED-TLSU, PTO-BLOCK-MODEL-DISPATCH-TILE-EXECUTION, PTO-BLOCK-MODEL-DISPATCH-TILE-SCALAR-SCHEMA, PTO-BLOCK-MODEL-DISPATCH-TILE-SCHEMA, PTO-BLOCK-MODEL-DISPATCH-TLSU-LAYOUT-CONVERSION, PTO-BLOCK-MODEL-OPERANDS-PORTABLE-CARRIERS, PTO-BLOCK-MODEL-OPERANDS-SHARED-GENERATION, PTO-TILE-GMOV, PTO-TILE-MGATHER, PTO-TILE-MGATHER-CAS, PTO-TILE-MGATHER-MASK, PTO-TILE-MSCATTER, PTO-TILE-MSCATTER-MASK, PTO-TILE-TCI, PTO-TILE-TCONCAT, PTO-TILE-TDEQUANT, PTO-TILE-TEXTRACT, PTO-TILE-TFILLPAD, PTO-TILE-TGATHER, PTO-TILE-TGEMV, PTO-TILE-TGEMV-ACC, PTO-TILE-TGEMV-BIAS, PTO-TILE-TGEMV-MX, PTO-TILE-TGEMV-MX-ACC, PTO-TILE-TGEMV-MX-BIAS, PTO-TILE-THISTOGRAM, PTO-TILE-TINSERT, PTO-TILE-TLOAD, PTO-TILE-TMATMUL, PTO-TILE-TMATMUL-ACC, PTO-TILE-TMATMUL-BIAS, PTO-TILE-TMATMUL-MX, PTO-TILE-TMATMUL-MX-ACC, PTO-TILE-TMATMUL-MX-BIAS, PTO-TILE-TMOV, PTO-TILE-TMRGSORT, PTO-TILE-TPACK, PTO-TILE-TPARTADD, PTO-TILE-TPARTMAX, PTO-TILE-TPARTMIN, PTO-TILE-TPARTMUL, PTO-TILE-TPERMUTE, PTO-TILE-TPREFETCH, PTO-TILE-TQUANT, PTO-TILE-TSCATTER, PTO-TILE-TSHUF, PTO-TILE-TSORT, PTO-TILE-TSTORE, PTO-TILE-TTRANS, PTO-TILE-TTRI, PTO-TILE-TUNPACK, PTO-TILE-MODEL-DISPATCH-IRREGULAR-AND-COMPLEX, PTO-TILE-MODEL-DISPATCH-LAYOUT-AND-REARRANGEMENT, PTO-TILE-MODEL-EXECUTION-COMPLEX, PTO-TILE-MODEL-EXECUTION-GENERATION, PTO-TILE-MODEL-EXECUTION-REARRANGEMENT, PTO-TILE-MODEL-LEGALITY-ALLOCATION-CAPACITY, PTO-TILE-MODEL-LEGALITY-DTYPE-LAYOUT, PTO-TILE-MODEL-LEGALITY-INDEXED-LAYOUT, PTO-TILE-MODEL-LEGALITY-LAYOUT-REARRANGEMENT, PTO-TILE-MODEL-LEGALITY-OPERAND-SCHEMA, PTO-TILE-MODEL-MEMORY-SHARED-MOVEMENT, PTO-TILE-MODEL-STATE-DESCRIPTORS, PTO-TILE-MODEL-STATE-SHARED-REGISTERS, PTO-TILE-MODEL-STATE-TYPES
    Affected NDF
    PTO-ARCH-GM-ACCESS-001, PTO-B-IOS-SHARED-STATE-001, PTO-B-IOT-STREAM-001, PTO-B-SHARED-WHOLE-PARENT-READY-001, PTO-B-SUBVIEW-SHARED-PER-PE-001, PTO-BSTART-TLOAD-MEMORY-001, PTO-BSTART-TMOV-SHARED-001, PTO-BSTART-TSTORE-MEMORY-001, PTO-INST-BLOCK-B-IOS, PTO-INST-BLOCK-B-IOT, PTO-INST-BLOCK-BSTART-TLOAD, PTO-INST-BLOCK-BSTART-TMATMUL, PTO-INST-BLOCK-BSTART-TMATMUL-ACC, PTO-INST-BLOCK-BSTART-TMATMUL-BIAS, PTO-INST-BLOCK-BSTART-TMATMULMX, PTO-INST-BLOCK-BSTART-TMATMULMX-ACC, PTO-INST-BLOCK-BSTART-TMATMULMX-BIAS, PTO-INST-BLOCK-BSTART-TMOV, PTO-INST-BLOCK-BSTART-TSTORE, PTO-INST-TILE-GMOV, PTO-INST-TILE-MGATHER, PTO-INST-TILE-MGATHER-CAS, PTO-INST-TILE-MGATHER-MASK, PTO-INST-TILE-MSCATTER, PTO-INST-TILE-MSCATTER-MASK, PTO-INST-TILE-TCI, PTO-INST-TILE-TCONCAT, PTO-INST-TILE-TDEQUANT, PTO-INST-TILE-TEXTRACT, PTO-INST-TILE-TFILLPAD, PTO-INST-TILE-TGATHER, PTO-INST-TILE-TGEMV, PTO-INST-TILE-TGEMV-ACC, PTO-INST-TILE-TGEMV-BIAS, PTO-INST-TILE-TGEMV-MX, PTO-INST-TILE-TGEMV-MX-ACC, PTO-INST-TILE-TGEMV-MX-BIAS, PTO-INST-TILE-THISTOGRAM, PTO-INST-TILE-TINSERT, PTO-INST-TILE-TLOAD, PTO-INST-TILE-TMATMUL, PTO-INST-TILE-TMATMUL-ACC, PTO-INST-TILE-TMATMUL-BIAS, PTO-INST-TILE-TMATMUL-MX, PTO-INST-TILE-TMATMUL-MX-ACC, PTO-INST-TILE-TMATMUL-MX-BIAS, PTO-INST-TILE-TMOV, PTO-INST-TILE-TMRGSORT, PTO-INST-TILE-TPACK, PTO-INST-TILE-TPARTADD, PTO-INST-TILE-TPARTMAX, PTO-INST-TILE-TPARTMIN, PTO-INST-TILE-TPARTMUL, PTO-INST-TILE-TPERMUTE, PTO-INST-TILE-TPREFETCH, PTO-INST-TILE-TQUANT, PTO-INST-TILE-TSCATTER, PTO-INST-TILE-TSHUF, PTO-INST-TILE-TSORT, PTO-INST-TILE-TSTORE, PTO-INST-TILE-TTRANS, PTO-INST-TILE-TTRI, PTO-INST-TILE-TUNPACK, PTO-ISA-LEGACY-SHARED-MOVEMENT-001, PTO-TFILLPAD-CONTRACT-001, PTO-TLOAD-MEMORY-001, PTO-TMATMUL-ACC-CONTRACT-001, PTO-TMATMUL-BIAS-CONTRACT-001, PTO-TMATMUL-CONTRACT-001, PTO-TMATMUL-MX-ACC-CONTRACT-001, PTO-TMATMUL-MX-BIAS-CONTRACT-001, PTO-TMATMUL-MX-CONTRACT-001, PTO-TPACK-CONTRACT-001, PTO-TPARTADD-CONTRACT-001, PTO-TPARTMAX-CONTRACT-001, PTO-TPARTMIN-CONTRACT-001, PTO-TPARTMUL-CONTRACT-001, PTO-TPERMUTE-CONTRACT-001, PTO-TSHUF-CONTRACT-001, PTO-TSTORE-MEMORY-001, PTO-TTRANS-CONTRACT-001, PTO-TUNPACK-CONTRACT-001
    SHA-256
    5689fa78a7291b6ae88d55197205e4cf79e9719ee5ba18ebf186f5c6871c350d
    Open exact decision source ↗ for ADR-0108

Unit metadata

Open 4 generated metadata fields
id
PTO-BLOCK-MODEL-DISPATCH-CELL-REARRANGEMENT-SCHEMA
surface
block
classification
[
  "model",
  "dispatch",
  "cell-rearrangement-schema"
]
depends_on
[
  "PTO-BLOCK-MODEL-DISPATCH-TILE-SCHEMA"
]
Open generated traceability record
{
  "classification": [
    "model",
    "dispatch",
    "cell-rearrangement-schema"
  ],
  "documentation": "docs/block/model/dispatch/cell-rearrangement-schema.md",
  "id": "PTO-BLOCK-MODEL-DISPATCH-CELL-REARRANGEMENT-SCHEMA",
  "mnemonic": null,
  "readiness_subjects": [
    "ADR-0108"
  ],
  "semantic_tests": [
    "PTO-AVS-BLOCK-CELL-REARRANGE-DECODED-001"
  ],
  "source": "asl/block/model/dispatch/cell-rearrangement-schema.asl",
  "surface": "block",
  "tests": [
    "PTO-AVS-BLOCK-CELL-REARRANGE-DECODED-001",
    "PTO-AVS-BLOCK-MODEL-DISPATCH-CELL-REARR-SCHEMA-STATIC-001"
  ]
}

Sources and release identity

Show commit, paths, hashes, version, and canonical owners
Release
0.58.5 · Release candidate
Commit
7dc8b7e5b121d2b2499a2273bebff29e2cd86812
ASL SHA-256
18f22fd96b5385ce47617c00aafdaa460c2fec6cab1cc867f28b1a772b259bc2
Generated documentation
docs/block/model/dispatch/cell-rearrangement-schema.md · embedded in this page
Documentation SHA-256
910f3a6b49bf2097ab4e14a2d7a581b4834c19f4d88d6e1326fed1c4c3915991

Exact owners