Skip to content

docs: refresh PTO micro instruction spec and runtime cases - #20

Draft
mouliangyu wants to merge 1 commit into
mainfrom
codex/update-micro-instruction-spec-v0.6
Draft

mouliangyu wants to merge 1 commit into
mainfrom
codex/update-micro-instruction-spec-v0.6

Conversation

@mouliangyu

@mouliangyu mouliangyu commented Aug 5, 2026

Copy link
Copy Markdown
Collaborator

概述

以 PTOAS d5072e79 为来源刷新 PTO-Gym 的 PTO micro Instruction 发布资产,包括规范手册、静态 VPTO runtime case 和验证 runner。旧 Gym 测试集合已被主仓后续重构淘汰,本 PR 将其替换为当前主仓发布快照,而不是继续在旧集合上增量叠加。

规范更新

  • docs/vpto-spec.md 与 18 个 micro-ISA 章节重新生成 v0.6 手册
  • 补齐当前 VPTO authoring、同步、DMA、vector、SIMT 等规范
  • 新增完整的 Special Scalar Operations 章节,覆盖 10 个 PTO scalar op
  • 记录 pto.ld_dev / pto.st_dev 的 AICore GM L1-bypass 语义、元素 offset、类型和版本约束
  • 保留 v0.1-v0.5 发布记录并更新内部章节链接与锚点

测试快照更新

  • 导出 230 个 PTOAS 五文件 kernel.pto runtime case,并保留从主仓 FlashAttention sample 适配的 FA case
  • 最终包含 231 个 case:132 micro-op、95 VMI、2 onboard-only、2 kernels
  • 删除 173 个已被主仓淘汰的旧 case,新增 124 个当前 case,更新 107 个保留路径
  • 同步分类级共享 helper 与 VMI case 说明文件
  • 更新 FA 使用当前 mte_l1_l0a/b 接口
  • 暂不导出 4 个依赖 PTOAS PTODSL simulator 环境的 kernel.py case

Runner 更新

  • 默认使用 --pto-backend=vpto --pto-arch a5
  • 支持 case-local ptoas.flags
  • SIM runtime sweep 自动跳过 onboard-only/,但保留 NPU 与 compile-only 入口
  • 不再清理固定 /tmp 目录,所有示例输出使用仓库内 .work
  • 更新 CANN 要求:9.0.0 official 或更新版本,部分 onboard-only case 需要 9.1.0 official

验证

  • release-doc bundle validation、18 个章节锚点和 10 个 Special Scalar op 唯一定义检查
  • 231 个 case 五文件完整性检查、Python py_compile、runner bash -ngit diff --check
  • 全量 compile-only:229/231 在 CANN 9.0.0 official 首轮通过;FA 修正后在 9.0.0 通过,register-swap onboard case 在 9.1.0 official 通过
  • ld-st-dev:CANN 9.0.0 official SIM runtime + golden compare PASS;9.0.0-beta.2 按版本门禁预期拒绝
  • 132 个 micro-op:CANN 9.1.0 official SIM runtime + golden compare 最终 132/132 PASS
  • FlashAttention 与 online-softmax-update:CANN 9.1.0 official SIM runtime + golden compare PASS

验证统一显式使用 PTOAS_FLAGS='--pto-backend=vpto --pto-arch a5'。未运行 NPU hardware runtime。

@mouliangyu
mouliangyu force-pushed the codex/update-micro-instruction-spec-v0.6 branch from 128643e to 0a35278 Compare August 5, 2026 04:57
@mouliangyu mouliangyu changed the title docs: refresh PTO micro instruction spec for v0.6 docs: refresh PTO micro instruction spec and runtime cases Aug 5, 2026
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.

1 participant