Skip to content

revise MGATHER/MSCATTER parameter model and add MASK variants#123

Open
bxrbyte wants to merge 1 commit into
LinxISA:mainfrom
bxrbyte:main
Open

revise MGATHER/MSCATTER parameter model and add MASK variants#123
bxrbyte wants to merge 1 commit into
LinxISA:mainfrom
bxrbyte:main

Conversation

@bxrbyte

@bxrbyte bxrbyte commented May 19, 2026

Copy link
Copy Markdown
  • MGATHER/MSCATTER: upgrade Col/Row to validCol/validRow/Col/Row four- parameter model; Row is hardware-derived from Tile Size; add PadValue (B.DATR) for gather padding fill; remove DepSrc/DepDst/B.IOD
  • Extend offset width from fixed uint16 to u64/u32/u16, resolved at runtime from the offset tile's element width
  • Add MGATHER.MASK (Function=6) and MSCATTER.MASK (Function=7): per- element predication via 1-bit MaskTile input; Col/Row directly specified (no validCol/validRow); masked-out positions write PadValue
  • Update TMA function encoding table and documentation site navigation

Summary

Describe what this PR changes and why.

Validation

  • bash tools/ci/check_repo_layout.sh
  • python3 tools/isa/build_golden.py --profile v0.56 --check
  • python3 tools/isa/validate_spec.py --profile v0.56
  • python3 tools/isa/check_canonical_v056.py --root .
  • python3 tools/bringup/check_avs_contract.py --matrix avs/linx_avs_v1_test_matrix.yaml
  • python3 tools/bringup/check_sail_model.py
  • mkdocs build --strict
  • (Optional) python3 tools/bringup/check_avs_profile_closure.py --matrix avs/linx_avs_v1_test_matrix.yaml --status avs/linx_avs_v1_test_matrix_status.json --tier pr
  • (Optional) bash tools/regression/run.sh

Submodules (if touched)

  • Submodule SHAs are intentional and minimal
  • .gitmodules URLs remain in the LinxISA org
  • Any cross-repo change was merged upstream first

@bxrbyte bxrbyte requested review from a team as code owners May 19, 2026 17:37

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces documentation for the new MGATHER.MASK and MSCATTER.MASK instructions and provides significant updates to the existing MGATHER and MSCATTER documentation, including new parameters for valid rows/columns and padding values. The review feedback points out that navigation links were added for English documentation files that are missing from the PR, which would result in broken links. Additionally, there is a suggestion to clarify the documentation for MSCATTER.MASK by explicitly referencing the size of the source tile instead of a non-existent Size parameter.

Comment thread mkdocs.zh.yml Outdated
Comment thread docs/zh/isa/header/tileblock/MSCATTER.MASK.md Outdated
Refine the parameter descriptions for MGATHER and MSCATTER instructions,
and introduce documentation for their MASK variants (MGATHER.MASK,
MSCATTER.MASK) with per-element predication semantics.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants