Skip to main content

PTO-ARCH-DATA-TYPES-INTEGER

PTO-ARCH-DATA-TYPES-INTEGER

ASL pseudocode

The complete ASL owner is shown directly below.

// PTO-UNIT: {"id":"PTO-ARCH-DATA-TYPES-INTEGER","surface":"arch","classification":["data-types","integer"],"depends_on":["PTO-ARCH-FEATURES-TILE-ALLOCATION"]}// Requirement references: PTO-REQ-STATE-001, PTO-REQ-TILE-001,// PTO-REQ-FAULT-001, PTO-REQ-MEMORY-TSO-001.
type Word of bits(PTO_XLEN);type DoubleWord of bits(PTO_XLEN * 2);type HalfWord of bits(32);type Byte of bits(8);type PredicateWord of bits(PTO_PREDICATE_WIDTH);type GPRIndex of integer {0..PTO_ABSOLUTE_GPR_COUNT-1};type PERegisterFile of array [[PTO_ABSOLUTE_GPR_COUNT]] of Word;type CorePEWords of array [[PTO_MODEL_MEMORY_AGENTS]] of Word;type Reg5Selector of integer {0..31};type TileIndex of integer {0..PTO_TILE_REGISTER_COUNT-1};type SharedTileID of bits(6);type SharedTileIndex of integer {0..PTO_SHARED_TILE_COUNT-1};type TemporaryQueueIndex of integer {0..PTO_TEMPORARY_QUEUE_DEPTH-1};type PredicateIndex of integer {0..PTO_PREDICATE_REGISTER_COUNT-1};type BundleDimensionIndex of integer {0..PTO_BUNDLE_DIMENSION_COUNT-1};type BundleScalarBindingIndex of integer {0..PTO_BUNDLE_SCALAR_BINDING_COUNT-1};type BundleTileBindingIndex of integer {0..PTO_BUNDLE_TILE_BINDING_COUNT-1};type BundleSharedBindingIndex of integer {0..3};type TileBaseIndex of integer {0..PTO_TILE_BASE_COUNT-1};type ModelTileElementIndex of integer {0..PTO_MODEL_TILE_ELEMENTS-1};type PackedTileElementIndex of integer {0..524287};type PackedTileCarrierIndex of integer {0..PTO_MODEL_TILE_ELEMENTS-1};type PackedTileLaneIndex of integer {0..15};type ModelAddress of integer {0..PTO_MODEL_MEMORY_BYTES-1};type SystemRegisterAddress of bits(24);type SystemRegisterFileIndex of integer {0..65535};type TrapNumber of bits(6);type InterruptID of integer {0..63};

Architecture behavior

purpose scope

Purpose and scope

This unit names the fixed-width carriers and bounded index domains shared by scalar, block, tile, memory, system-register, and trap owners.

Central type ownership lets ASL signatures expose which architectural domain an integer belongs to instead of passing unconstrained integers everywhere.

concepts state

Concepts and visible state

  • Word, DoubleWord, HalfWord, and Byte are PTO_XLEN, PTO_XLEN * 2, 32, and 8 bits respectively; PredicateWord uses PTO_PREDICATE_WIDTH.
  • Register and binding indices are bounded by their owning count constants, including GPRIndex, TileIndex, PredicateIndex, and the bundle binding index types.
  • Address-facing types separate ModelAddress, 24-bit SystemRegisterAddress, and 16-bit-file SystemRegisterFileIndex; traps use six-bit TrapNumber and 0..63 InterruptID.
rules interactions

Rules and interactions

Array types such as PERegisterFile and CorePEWords derive their extents from model constants rather than introducing new architectural counts.

SharedTileID is a six-bit carrier, while SharedTileIndex is a bounded integer index; callers must not treat those distinct roles as interchangeable.

Packed tile indices have explicit model bounds: element 0..524287, carrier 0..PTO_MODEL_TILE_ELEMENTS-1, and lane 0..15.

boundaries

Architectural boundaries

Bounds containing PTO_MODEL_* are verification-model bounds. They are not claims that every implementation has the same physical capacity.

This unit defines types only; state allocation, access checks, faults, and instruction effects remain in the owners that consume them.

example usage

illustrative reading example

A function accepting TileIndex can only receive an index in 0..PTO_TILE_REGISTER_COUNT-1; a six-bit SharedTileID still requires an explicit mapping before it can serve as a SharedTileIndex.

Read a model-bound array extent as a type-checking contract for this ASL model, then follow the consuming state owner for architecture-visible capacity rules.

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 evidence1
  • PTO-ARCH-DATA-TYPES-INTEGER compiles as an independent normative unit
    1. surfaceARCH
    2. ownerPTO-ARCH-DATA-TYPES-INTEGER
    3. categorySTATIC-INVARIANT
    4. case001
    Show exact test source
    Sources and references
    Complete stable ID
    PTO-AVS-ARCH-DATA-TYPES-INTEGER-STATIC-001
    Path
    tests/asl/arch/data-types/integer/arch-static-integer-contract-001.asl
    Kind / role
    static-invariant
    Pass condition
    the complete model and this unit's static invariant compile
    SHA-256
    e1f308efd1e2f8cc8c7ef4b8cf8ed241041da15e44aa225ffac0f9ff6946d77b
    Open exact source ↗ for PTO-AVS-ARCH-DATA-TYPES-INTEGER-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 history2
  • Re-encode B.IOT and B.IOS size and PE mode fields · accepted
    1. decision recordADR
    2. case0096

    Decision record

    Loading ADR-0096…

    Sources and references
    Complete stable ID
    ADR-0096
    Path
    docs/status/decisions/0096-b-iot-b-ios-sizecode-pemode.md
    Affected units
    PTO-ARCH-DATA-TYPES-INTEGER, PTO-ARCH-FEATURES-TILE-ALLOCATION, PTO-ARCH-MEMORY-MODEL-GLOBAL-MEMORY-ACCESS, PTO-ARCH-PROFILE-RESET, PTO-ARCH-PROGRAMMING-MODEL-CORE-PE-TOPOLOGY, PTO-BLOCK-B-IOS, PTO-BLOCK-B-IOT, PTO-BLOCK-MODEL-DISPATCH-COMMANDS, PTO-BLOCK-MODEL-DISPATCH-CUBE-TMATMUL, PTO-BLOCK-MODEL-DISPATCH-DESTINATION-SHAPE, PTO-BLOCK-MODEL-DISPATCH-SHARED-CUBE-MATRIX, PTO-BLOCK-MODEL-DISPATCH-SHARED-TLSU, PTO-BLOCK-MODEL-OPERANDS-SHARED-BINDINGS, PTO-BLOCK-MODEL-OPERANDS-TILE-BINDINGS, PTO-BLOCK-MODEL-SCHEMA-PROFILE-ENCODING, PTO-BLOCK-MODEL-STATE-TYPES, PTO-TILE-MODEL-DEFINEDNESS-ELEMENTS, PTO-TILE-MODEL-DEFINEDNESS-PACKED-BOUNDARY, PTO-TILE-MODEL-EXECUTION-COMPARISON, PTO-TILE-MODEL-EXECUTION-COMPLEX, PTO-TILE-MODEL-EXECUTION-CUBE, PTO-TILE-MODEL-EXECUTION-ELEMENTWISE, PTO-TILE-MODEL-EXECUTION-EXPANSION, PTO-TILE-MODEL-EXECUTION-FUSED-MULTIPLY-ADD, PTO-TILE-MODEL-EXECUTION-GENERATION, PTO-TILE-MODEL-EXECUTION-IMAGE-TO-COLUMN, PTO-TILE-MODEL-EXECUTION-INDEXED-REARRANGEMENT, PTO-TILE-MODEL-EXECUTION-REARRANGEMENT, PTO-TILE-MODEL-EXECUTION-REDUCTION, PTO-TILE-MODEL-EXECUTION-SORTING, PTO-TILE-MODEL-EXECUTION-UNARY, PTO-TILE-MODEL-LEGALITY-ALLOCATION-CAPACITY, PTO-TILE-MODEL-LEGALITY-DESCRIPTOR-SHAPE, PTO-TILE-MODEL-LEGALITY-IMAGE-TO-COLUMN, PTO-TILE-MODEL-LEGALITY-INDEXED-REARRANGEMENT, PTO-TILE-MODEL-LEGALITY-MATRIX-INFO-DESCRIPTOR, PTO-TILE-MODEL-LEGALITY-MATRIX-POSTPROCESS, PTO-TILE-MODEL-LEGALITY-PE-MASK, PTO-TILE-MODEL-MEMORY-LOAD-STORE, PTO-TILE-MODEL-MEMORY-SHARED-MOVEMENT, PTO-TILE-MODEL-NUMERIC-FORMATS, PTO-TILE-MODEL-ORDERING-SORTING, PTO-TILE-MODEL-SHAPE-VALID-REGION, PTO-TILE-MODEL-STATE-ALLOCATION, PTO-TILE-MODEL-STATE-DESCRIPTORS, PTO-TILE-MODEL-STATE-FEATURE-MAP-DESCRIPTORS, PTO-TILE-MODEL-STATE-SHARED-REGISTERS, PTO-TILE-MODEL-STATE-TYPES, PTO-TILE-TLOAD
    Affected NDF
    PTO-ARCH-GM-ACCESS-001, PTO-B-IOS-SHARED-STATE-001, PTO-B-IOT-STREAM-001, PTO-CUBE-ACCUMULATOR-OUTPUT-001, PTO-TLOAD-CUBE-001, PTO-TLOAD-MEMORY-001
    SHA-256
    c4b4fb7bc17878f710015207dc19ddaf22a0cf6989d185b16844714c71e23f62
    Open exact decision source ↗ for ADR-0096
  • Local and Shared capacity pools with cooperative M-sharding · accepted
    1. decision recordADR
    2. case0097

    Decision record

    Loading ADR-0097…

    Sources and references
    Complete stable ID
    ADR-0097
    Path
    docs/status/decisions/0097-local-shared-capacity-and-cooperative-m-sharding.md
    Affected units
    PTO-ARCH-DATA-TYPES-INTEGER, PTO-ARCH-FEATURES-TILE-ALLOCATION, PTO-ARCH-OVERVIEW-ARCHITECTURE, PTO-ARCH-PROGRAMMING-MODEL-CORE-PE-TOPOLOGY, PTO-BLOCK-B-IOS, PTO-BLOCK-B-IOT, PTO-BLOCK-MODEL-DISPATCH-COMMANDS, PTO-BLOCK-MODEL-DISPATCH-CUBE-DESTINATION, PTO-BLOCK-MODEL-DISPATCH-CUBE-TMATMUL, PTO-BLOCK-MODEL-DISPATCH-DESTINATION-SHAPE, PTO-BLOCK-MODEL-DISPATCH-SHARED-CUBE-MATRIX, PTO-BLOCK-MODEL-OPERANDS-SHARED-BINDINGS, PTO-BLOCK-MODEL-STATE-TYPES, PTO-TILE-MODEL-CAPACITY-LOCAL, PTO-TILE-MODEL-CAPACITY-SHARED, PTO-TILE-MODEL-MEMORY-SHARED-MOVEMENT, PTO-TILE-MODEL-STATE-ALLOCATION, PTO-TILE-MODEL-STATE-DESCRIPTORS, PTO-TILE-MODEL-STATE-SHARED-REGISTERS, PTO-TILE-MODEL-STATE-TYPES
    Affected NDF
    PTO-B-IOS-SHARED-STATE-001, PTO-B-IOT-STREAM-001, PTO-CUBE-GROUP-M-DISTRIBUTION-001, PTO-TILE-CAPACITY-PER-PE
    SHA-256
    7de93019f9272a73d5f42e42bec242725edadbcf41ed34a3155d40fb37f0cd14
    Open exact decision source ↗ for ADR-0097

Unit metadata

Open 4 generated metadata fields
id
PTO-ARCH-DATA-TYPES-INTEGER
surface
arch
classification
[
  "data-types",
  "integer"
]
depends_on
[
  "PTO-ARCH-FEATURES-TILE-ALLOCATION"
]
Open generated traceability record
{
  "classification": [
    "data-types",
    "integer"
  ],
  "documentation": "docs/arch/data-types/integer.md",
  "id": "PTO-ARCH-DATA-TYPES-INTEGER",
  "mnemonic": null,
  "readiness_subjects": [
    "ADR-0096",
    "ADR-0097"
  ],
  "semantic_tests": [],
  "source": "asl/arch/data-types/integer.asl",
  "surface": "arch",
  "tests": [
    "PTO-AVS-ARCH-DATA-TYPES-INTEGER-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
90d7132478de54d665d973587b61c3ecfd5e57645e5985aef5918b4b722e816d
Generated documentation
docs/arch/data-types/integer.md · embedded in this page
Documentation SHA-256
37338cb3ceb4b0da61e8555e62ba55351306221144111c0e99bd7f93f57ba04e

Exact owners