Skip to main content

PTO-ARCH-DATA-TYPES-FORMAT-E2M1X2

PTO-ARCH-DATA-TYPES-FORMAT-E2M1X2

ASL pseudocode

This Operation comes directly from the instruction owner; the page does not rewrite its behavior.

// PTO-REQ-HARDWARE-NUMERIC-001: exact E2M1 logical lanes.
pure func E2M1X2NumericFormatDescriptor() => NumericFormatDescriptorbegin    return NumericFormatDescriptor {        available = TRUE, kind = NumericFormatKind_FixedBinary,        carrier_bits = 8, lane_bits = 4, lanes_per_carrier = 2,        sign_bits = 1, sign_bit = 3,        exponent_bits_min = 2, exponent_bits_max = 2,        fraction_bits_min = 1, fraction_bits_max = 1,        exponent_bias_available = TRUE, exponent_bias = 1,        required_low_zero_bits = 0, required_high_zero_bits = 0,        has_zero = TRUE, has_signed_zero = TRUE, has_subnormal = FALSE,        has_infinity = FALSE, has_quiet_nan = FALSE,        has_signaling_nan = FALSE    };end;
pure func E2M1X2FiniteDecomposition(value: Word)    => (boolean, boolean, Word, integer {-1074..1023})begin    let lane = value[3:0];    let exponent = lane[2:1];    let fraction = lane[0:0];    if exponent == Zeros{2} then        if fraction == Zeros{1} then            return (TRUE, lane[3] == '1', Zeros{PTO_XLEN}, 0);        else return (TRUE, lane[3] == '1', Zeros{PTO_XLEN} + 1, -1);        end;    else return (TRUE, lane[3] == '1',                 LSL(Zeros{PTO_XLEN} + 1, 1) +                     ZeroExtend{PTO_XLEN}(fraction),                 (UInt(exponent) - 2) as integer {-1074..1023});    end;end;pure func ClassifyE2M1X2(value: Word) => NumericValueClassbegin    return NumericValueClassFromFiniteSign(value[3],        value[2:0] == Zeros{3}, FALSE);end;
pure func E2M1X2SignedZeroEncodings() => (Word, Word)begin    return (Zeros{PTO_XLEN}, Zeros{PTO_XLEN} + 0x8);end;
View the complete ASL owner
// PTO-UNIT: {"id":"PTO-ARCH-DATA-TYPES-FORMAT-E2M1X2","surface":"arch","classification":["data-types","formats","e2m1x2"],"depends_on":["PTO-ARCH-DATA-TYPES-FORMAT-DESCRIPTOR"]}// DOC-BEGIN: operation// PTO-REQ-HARDWARE-NUMERIC-001: exact E2M1 logical lanes.
pure func E2M1X2NumericFormatDescriptor() => NumericFormatDescriptorbegin    return NumericFormatDescriptor {        available = TRUE, kind = NumericFormatKind_FixedBinary,        carrier_bits = 8, lane_bits = 4, lanes_per_carrier = 2,        sign_bits = 1, sign_bit = 3,        exponent_bits_min = 2, exponent_bits_max = 2,        fraction_bits_min = 1, fraction_bits_max = 1,        exponent_bias_available = TRUE, exponent_bias = 1,        required_low_zero_bits = 0, required_high_zero_bits = 0,        has_zero = TRUE, has_signed_zero = TRUE, has_subnormal = FALSE,        has_infinity = FALSE, has_quiet_nan = FALSE,        has_signaling_nan = FALSE    };end;
pure func E2M1X2FiniteDecomposition(value: Word)    => (boolean, boolean, Word, integer {-1074..1023})begin    let lane = value[3:0];    let exponent = lane[2:1];    let fraction = lane[0:0];    if exponent == Zeros{2} then        if fraction == Zeros{1} then            return (TRUE, lane[3] == '1', Zeros{PTO_XLEN}, 0);        else return (TRUE, lane[3] == '1', Zeros{PTO_XLEN} + 1, -1);        end;    else return (TRUE, lane[3] == '1',                 LSL(Zeros{PTO_XLEN} + 1, 1) +                     ZeroExtend{PTO_XLEN}(fraction),                 (UInt(exponent) - 2) as integer {-1074..1023});    end;end;pure func ClassifyE2M1X2(value: Word) => NumericValueClassbegin    return NumericValueClassFromFiniteSign(value[3],        value[2:0] == Zeros{3}, FALSE);end;
pure func E2M1X2SignedZeroEncodings() => (Word, Word)begin    return (Zeros{PTO_XLEN}, Zeros{PTO_XLEN} + 0x8);end;// DOC-END: operation

Architecture behavior

purpose scope

Purpose and scope

E2M1X2 is an assigned PTO numeric format. This page helps a reader connect its carrier layout, finite-value decomposition, and value classification; the exact contract remains in E2M1X2NumericFormatDescriptor, E2M1X2FiniteDecomposition, and ClassifyE2M1X2 in the ASL owner.

concepts state

Carrier and fields

The descriptor uses a 8-bit carrier, a 4-bit logical lane, and 2 lane(s) per carrier. The lane has one sign bit at position 3, 2 exponent bit(s), 1 fraction bit(s), and exponent bias 1.

The descriptor covers one four-bit logical lane at a time; two lanes share the eight-bit carrier.

rules interactions

Decomposition and classification

E2M1X2FiniteDecomposition reports whether a finite decomposition is available and, when available, returns the sign, an integer significand, and a binary exponent. ClassifyE2M1X2 separately assigns the raw lane to zero, subnormal, normal, infinity, or NaN classes supported by this format.

It has signed zero but no subnormal class, infinity, or NaN class. Every nonzero four-bit lane is classified as a signed normal value.

boundaries

Boundaries and exact encodings

Lane encodings 0x0 and 0x8 are positive and negative zero.

The finite-decomposition function reports availability with its returned tuple; value classification is a separate function result.

example usage

illustrative reading example

This example illustrates how to read the functions; it does not add an encoding rule.

For example, lane 0x1 decomposes to positive significand 1 with exponent -1; lane 0x9 has the same magnitude and a negative sign.

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
  • PTO-ARCH-DATA-TYPES-FORMAT-E2M1X2 compiles as an independent normative unit
    1. surfaceARCH
    2. ownerPTO-ARCH-DATA-TYPES-FORMAT-E2M1X2
    3. categorySTATIC-INVARIANT
    4. case001
    Show exact test source
    Sources and references
    Complete stable ID
    PTO-AVS-ARCH-DATA-TYPES-FORMAT-E2M1X2-STATIC-001
    Path
    tests/asl/arch/data-types/formats/e2m1x2/arch-static-e2m1x2-contract-001.asl
    Kind / role
    static-invariant
    Pass condition
    the complete model and this unit's static invariant compile
    SHA-256
    3f71af2de59d2867f4833c4617e33b7baaf07844357b3db99bf8a641560c678a
    Open exact source ↗ for PTO-AVS-ARCH-DATA-TYPES-FORMAT-E2M1X2-STATIC-001
  • E2M1X2 exposes its exact descriptor and finite-value decomposition.
    1. surfaceARCH
    2. ownerPTO-ARCH-DATA-TYPES-FORMAT-E2M1X2
    3. categoryBOUNDARY
    4. case001
    Show exact test source
    Sources and references
    Complete stable ID
    PTO-AVS-ARCH-E2M1X2-DECOMP-001
    Path
    tests/asl/arch/data-types/formats/e2m1x2/arch-bound-e2m1x2-decomp-001.asl
    Kind / role
    boundary
    Requirements
    PTO-NUMERIC-FINITE-DECOMPOSITION-001
    Pass condition
    Field metadata, finite boundaries, unavailable special values, and existing value-class rules agree.
    SHA-256
    db698d1b685e9f471ba4a645ef2c71074409a5870be0ee51fc893771037f7d44
    Open exact source ↗ for PTO-AVS-ARCH-E2M1X2-DECOMP-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
  • Numeric format value classification · accepted
    1. decision recordADR
    2. case0048

    Decision record

    Loading ADR-0048…

    Sources and references
    Complete stable ID
    ADR-0048
    Path
    docs/status/decisions/0048-numeric-format-value-classification.md
    Affected units
    PTO-ARCH-DATA-TYPES-FORMAT-BF16, PTO-ARCH-DATA-TYPES-FORMAT-DESCRIPTOR, PTO-ARCH-DATA-TYPES-FORMAT-E1M2X2, PTO-ARCH-DATA-TYPES-FORMAT-E2M1X2, PTO-ARCH-DATA-TYPES-FORMAT-E2M3, PTO-ARCH-DATA-TYPES-FORMAT-E3M2, PTO-ARCH-DATA-TYPES-FORMAT-E4M3, PTO-ARCH-DATA-TYPES-FORMAT-E5M2, PTO-ARCH-DATA-TYPES-FORMAT-E8M0, PTO-ARCH-DATA-TYPES-FORMAT-FP16, PTO-ARCH-DATA-TYPES-FORMAT-FP32, PTO-ARCH-DATA-TYPES-FORMAT-FP64, PTO-ARCH-DATA-TYPES-FORMAT-HF32, PTO-ARCH-DATA-TYPES-FORMAT-HIF4X2, PTO-ARCH-DATA-TYPES-FORMAT-HIF8, PTO-ARCH-DATA-TYPES-FORMAT-TF32, PTO-ARCH-DATA-TYPES-NUMERIC-CLASSIFICATION, PTO-ARCH-DATA-TYPES-NUMERIC-FORMATS, PTO-SCALAR-FMAX, PTO-SCALAR-FMIN, PTO-SCALAR-MODEL-FSU-PROFILE, PTO-TILE-MODEL-EXECUTION-COMPARISON, PTO-TILE-MODEL-EXECUTION-FUSED-MULTIPLY-ADD, PTO-TILE-MODEL-EXECUTION-UNARY, PTO-TILE-MODEL-NUMERIC-FORMATS, PTO-TILE-MODEL-ORDERING-SORTING, PTO-TILE-TMAX, PTO-TILE-TMIN
    Affected NDF
    PTO-FMAX-DECISION-BINDING-001, PTO-FMIN-DECISION-BINDING-001, PTO-NUMERIC-FINITE-DECOMPOSITION-001, PTO-NUMERIC-FORMAT-DESCRIPTOR-001, PTO-TMAX-CONTRACT-001, PTO-TMIN-CONTRACT-001
    SHA-256
    ce3ecd1851e22b5517d07076ab8bd2db36b6b4582111c761db19240275853d9c
    Open exact decision source ↗ for ADR-0048

Unit metadata

Open 4 generated metadata fields
id
PTO-ARCH-DATA-TYPES-FORMAT-E2M1X2
surface
arch
classification
[
  "data-types",
  "formats",
  "e2m1x2"
]
depends_on
[
  "PTO-ARCH-DATA-TYPES-FORMAT-DESCRIPTOR"
]
Open generated traceability record
{
  "classification": [
    "data-types",
    "formats",
    "e2m1x2"
  ],
  "documentation": "docs/arch/data-types/formats/e2m1x2.md",
  "id": "PTO-ARCH-DATA-TYPES-FORMAT-E2M1X2",
  "mnemonic": null,
  "readiness_subjects": [
    "ADR-0048"
  ],
  "semantic_tests": [
    "PTO-AVS-ARCH-E2M1X2-DECOMP-001"
  ],
  "source": "asl/arch/data-types/formats/e2m1x2.asl",
  "surface": "arch",
  "tests": [
    "PTO-AVS-ARCH-DATA-TYPES-FORMAT-E2M1X2-STATIC-001",
    "PTO-AVS-ARCH-E2M1X2-DECOMP-001"
  ]
}

Sources and release identity

Show commit, paths, hashes, version, and canonical owners
Release
0.58.5 · Release candidate
Commit
7dc8b7e5b121d2b2499a2273bebff29e2cd86812
ASL SHA-256
8c6ba2f9a03a48e1e09c8b93b0a8222ebe0c079b28c5ee98d0f16a11f48ee0eb
Generated documentation
docs/arch/data-types/formats/e2m1x2.md · embedded in this page
Documentation SHA-256
dbac308a1de72a90f956a8f828f6c4b67ae15698bd471751eceb29aa8eed7c1b

Exact owners