Skip to content

Reclassify TSETFMATRIX / TSET_IMG2COL_* / TGET_SCALE_ADDR as micro instructions and remove them from tile docs #90

@zhoubot

Description

@zhoubot

Problem

The current PTO ISA documentation still presents the following T* APIs as part of the tile instruction surface:

  • TSETFMATRIX
  • TSET_IMG2COL_RPT
  • TSET_IMG2COL_PADDING
  • TGET_SCALE_ADDR

That categorization is misleading at the API/semantic level.

These operations do not primarily describe tile payload transformation. They program or derive control/state used by later execution:

  • TSETFMATRIX programs FMATRIX-related configuration state.
  • TSET_IMG2COL_RPT programs IMG2COL repeat metadata.
  • TSET_IMG2COL_PADDING programs IMG2COL padding metadata.
  • TGET_SCALE_ADDR derives/binds an address relationship rather than performing tile arithmetic.

As a result, the tile-family docs overstate what the tile surface actually is, and PTO-AS / ISA taxonomy remains blurry.

Requested change

Reclassify these four operations into the micro-instruction surface and temporarily remove them from the tile instruction documentation.

This should be treated as a semantic/API taxonomy change, not just a wording tweak.

Scope

Reclassify

Move the semantic classification of:

  • TSETFMATRIX
  • TSET_IMG2COL_RPT
  • TSET_IMG2COL_PADDING
  • TGET_SCALE_ADDR

from tile-instruction docs into the micro-instruction docs.

Temporarily remove from tile docs

Until the micro-instruction placement is complete, remove these ops from tile-instruction taxonomies and tile-family summaries so the tile docs remain semantically clean.

Affected documentation areas

At minimum, review and update:

  • docs/isa/instruction-surfaces/tile-instructions*.md
  • docs/isa/instruction-families/tile-families*.md
  • docs/isa/instruction-surfaces/README*.md
  • docs/assembly/PTO-AS*.md
  • docs/mkdocs/src/manual/07-instructions*.md
  • docs/isa/manifest.yaml
  • generated index / matrix outputs derived from the manifest
  • the micro-instruction landing / group pages under docs/isa/scalar/ops/micro-instruction/

Acceptance criteria

  • The tile instruction docs no longer classify these four operations as tile instructions.
  • The micro-instruction docs explicitly include and explain these four operations.
  • PTO-AS docs make the semantic family clear and do not imply that a T* name automatically belongs to the tile surface.
  • docs/isa/manifest.yaml and generated family/index pages reflect the new classification.
  • English and Chinese docs remain aligned.
  • git diff --check passes.
  • Manifest-derived doc generation/check scripts pass.

Notes

This issue is intentionally limited to these four operations. A broader semantic cleanup of the T* namespace may still be needed later, but that should be tracked separately.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Status

    No status

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions