Parallel Tile Operation (PTO) is a virtual instruction set architecture designed by Ascend CANN, focusing on tile-level operations. This repository offers high-performance, cross-platform tile operations across Ascend platforms.

文件	最后提交记录	最后更新时间
.gitcode	update ISSUE_TEMPLATE Co-authored-by: zoujiangjiang<zoujiangjiang@h-partners.com> # message auto-generated for no-merge-commit merge: !894 merge update-issue-template into master update ISSUE_TEMPLATE Created-by: zoujiangjiang Commit-by: zoujiangjiang Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> issue模板增加双语描述 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/pto-isa!894	2 个月前
agents	Repo-wide pre-commit: strip trailing whitespace and normalize EOF newlines Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1320 merge master into master Repo-wide pre-commit: strip trailing whitespace and normalize EOF newlines Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhhywang Commit-by: zhhywang Merged-by: cann-robot Description: 全仓跑 `trailing-whitespace` + `end-of-file-fixer`：剥离行尾空白、补缺失末行换行、删多余尾随空行；零逻辑/语义变更，覆盖 tests/docs/include/kernels/demos 及 .py/.md/.sh/.js。 ## 描述全仓 pre-commit 自动修复扫描，仅做空白与行尾归一，零逻辑变更： - 行尾空白：剥离行末多余空格/制表符（主体；.cpp/.hpp/.h/.md/.py/.sh/.js 全覆盖）。 - 文件尾换行：补缺失末行换行（多处 `\ No newline at end of file`）、删多余尾随空行，统一单换行结尾。 `git diff -w` 仅余 250 文件（皆为 EOF 换行/空行修复，`-w` 不抑制空行变更），其余 ~903 文件纯行尾空白；逐类抽样（.cpp/.hpp/.py/.md/setup.py/SKILL.md）均为空白归一，无 token 变化。 ## 关联的Issue ## 测试 - 空白归一收敛：`git diff -w --stat` = 250 文件 +46/−365；抽样 `.cpp` 文件 `-w` diff 为空（纯行尾空白）。 - 无逻辑变更：无标识符 rename、无代码增删，仅空白/换行。 - ⚠️ 未做编译验证（本机无 CANN/CPU-sim 工具链）；空白不改语义，建议可编译环境跑一次 build 复核。 - 改动量：1153 文件，+15054 / −15373（.cpp 634 / .md 298 / .hpp 175 / .py 18 / .sh 13 / .h 12 / .js 3）。 ## 文档更新无文档内容改动；.md 仅为行尾空白/EOF 换行归一。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：全仓 pre-commit 空白归一——trailing-whitespace + end-of-file-fixer，清理行尾空白、统一末行换行；零逻辑变更。 See merge request: cann/pto-isa!1320	5 天前
cmake	build: upgrade json third-party from v3.11.3 to v3.12.0 Co-authored-by: zoujiangjiang<zoujiangjiang@h-partners.com> # message auto-generated for no-merge-commit merge: !1308 merge upgrade-json-3.11.3-to-3.12.0 into master build: upgrade json third-party from v3.11.3 to v3.12.0 Created-by: zoujiangjiang Commit-by: zoujiangjiang Merged-by: cann-robot Description: ## 关联 Issue Closes #482 ## 变更内容将 cmake/third_party/json.cmake 中 nlohmann/json 第三方依赖的下载版本从 v3.11.3 升级到 v3.12.0。 ## 变更范围仅修改下载 URL 中的版本号，单行改动： - v3.11.3/include.zip -> v3.12.0/include.zip json 为 header-only 依赖，URL 模板与旧版一致，无接口签名/构建逻辑变更。 ## 校验 - 已确认 v3.12.0/include.zip 下载地址有效（ZIP 文件，PK 魔数校验通过）。 See merge request: cann/pto-isa!1308	5 天前
demos	typo-fix + eof: correct misspellings/rename identifiers (codespell/typos) and fix missing EOF newlines Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1337 merge master into master typo-fix + eof: correct misspellings/rename identifiers (codespell/typos) and fix missing EOF newlines Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhywang Commit-by: zhywang Merged-by: cann-robot Description: 全仓拼写清理 + EOF 换行归一——新增 `typos.toml`（typos 工具配置）扫描源码拼写并据此修正字符串/注释/文档拼写，将拼错的内部标识符（命名空间、include guard、函数/变量名）一并改名；codespell `-L` 白名单扩展领域词；含文件名修正及少量 ruff 无用 import 清理。另补 41 个文件缺失的末行换行（end-of-file-fixer）。`compatiable` 作为外部 CANN-cmake 依赖文件名保留并加白名单。 ## 描述 158 文件 +323/−310，拼写归一，含标识符 rename（非纯格式化）： - 配置：新增 `typos.toml`（领域词/短标识符白名单：nd/cann/subtile/fo/adn/eles/ands/tbe/typ/pn/binar/alog/mis/vitaliy/compatiable、SUBTILE/SUBTILES）；`.pre-commit-config.yaml` 仅扩展 codespell `-L` 白名单（+fo/adn/eles/binar/mis/compatiable），`--skip .py/.cpp/.hpp/.c/.h` 不变（源码拼写由 typos 工具负责）。 - 标识符 rename（内部符号，同文件/编译单元内调用点同步更新）： - 命名空间 `TMatmulInternel`→`TMatmulInternal`、`TCvtInternel`→`TCvtInternal` - include guard `EXTENTION_CSRC_UTILS_H`→`EXTENSION_`、`ELEMENT_TILE_SCLAR_OP_HPP`→`...SCALAR...` - 函数 `ReachExhaused`/`WriteExhaused`→`...Exhausted`、`complate_s32/s16_data`→`complete_` - 变量 `vaild`/`Vaild`→`valid`/`Valid`（77 处，主体）、`fpAddres`→`fpAddress`、`enbleCountMode`→`enableCountMode`、`NeetCntDstIdx`→`NeedCntDstIdx`、`paramter`→`parameter` - 字符串/注释/文档拼写：`convertion`→`conversion`、`Unsupport`→`Unsupported`、`ony`→`only`、`Undelying`→`Underlying`、`Indicies`→`Indices`、`differnent`→`different`、`Iteraions`→`Iterations`、`Simpify`→`Simplify`、`addressess`→`addresses`、`particulary`→`particularly`、`seperate`→`separate`、`accross`→`across`（.md 中英双语同步）。 - 文件名修正：图 `permuate_all2all_count.png`→`permute_all2all_count.png`。 - EOF 换行归一（end-of-file-fixer）：41 个文件补缺失末行 `\n`——本 PR 涉及的 `ElementOp.h`、`tcmp(s)/gen_data.py`、kirinDev0000 5 个 `main.cpp`（10）+ 全仓其余 kirinDev0000 testcases 与 `tinterleave`（31）；多尾随换行 0。 - `compatiable`：外部依赖 `version_compatiable.inc` 路径改名已撤回，改为白名单（须与依赖方拼写一致）。 - ruff：删少量无用 import（`shutil`、`Tuple`）。 ## 关联的Issue ## 测试 - 标识符一致性：各 rename 均在所在文件内同步更新定义与调用点，行为不变。 - 白名单收敛：`typos.toml`/codespell `-L` 已收录全部领域词与外部依赖名，避免误报。 - EOF 验证：全仓复扫缺/多末行换行均 0；`pre-commit run end-of-file-fixer --all-files` Passed（CI 等价）。 - ⚠️ 含标识符 rename（非纯格式化），本机无 CANN/CPU-sim 工具链未做编译/单测；建议可编译环境跑一次 build + 测试复核（重点确认 namespace/guard/`valid` 系列无外部引用残留）。 - 改动量*：158 文件 +323/−310（.cpp 77 / .hpp 34 / .py 24 / .md 9 / .h 7 / .sh 4 / .yaml 1 / .toml 1 / .png 1）。 ## 文档更新 .md 仅修正拼写（中英双语），无内容/结构改动。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他，请描述：全仓拼写清理（codespell/typos 修正拼写、rename 拼错标识符、新增 typos.toml）+ EOF 末行换行归一（end-of-file-fixer，41 文件）；外部依赖名 compatiable 加白名单保留。 See merge request: cann/pto-isa!1337	4 天前
docs	docs: normalize product naming and Chinese-ASCII spacing in ISA _zh docs Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1350 merge master into master docs: normalize product naming and Chinese-ASCII spacing in ISA _zh docs Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhywang Commit-by: zhywang Merged-by: cann-robot Description: 对 `docs/isa/` 下 124 个中文 ISA 文档统一应用 CANN 文档规范——产品名规范化（`A2A3`/`A5`/`Ascend950` → 规范全称）+ 中英文（中文与 ASCII 字母/数字）间空格归一（移除多余空格）。纯文档格式化，无内容/结构改动。 ## 描述 124 文件 +1986/−1986，全为 `.md`，增删行数相等（纯行内替换）： - 范围：`docs/isa/`（115）+ `docs/isa/comm/`（9）；无源码/配置改动。 - 产品名规范化（短码 → CANN 规范全称）： - `(A2A3)` → `(Atlas A2/A3 训练系列产品/Atlas A2/A3 推理系列产品)`（48 处） - `(A5)` → `(Ascend 950PR/Ascend 950DT)`（55 处） - `Ascend950` → `Ascend 950PR/Ascend 950DT`（8 处） - 中英文空格归一：移除中文字符与相邻 ASCII 字母/数字之间的空格（占改动主体），如 `两个 Tile`→`两个Tile`、`C++ 内建接口`→`C++内建接口`、`以及 ND->NZ`→`以及ND->NZ`；反引号代码标识符内部不受影响。 ## 关联的Issue ## 测试 - 纯文档修改，无代码/构建产物变更，无需编译/单测。 - 一致性：产品名替换与中英文空格规则全仓统一应用；保留路径（如 `tests/npu/a5/...`）、芯片型号（`910B1/B4`）、arch（`dav-c220`）、`.ascend.meta` section 名、`Ascend C` 语言名等不在规范化范围（正确未改）。 - 改动量：124 文件 +1986/−1986（.md only）。 ## 文档更新仅修正产品名与中英文空格格式，无内容/结构改动。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/pto-isa!1350	23 小时前
include	[CPU-SIM] TADDEQRELU impl Co-authored-by: Azizbek<habibov.azizbek@h-partners.com> # message auto-generated for no-merge-commit merge: !1340 merge add into master [CPU-SIM] TADDEQRELU impl Created-by: Azizbek Commit-by: Azizbek Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/pto-isa!1340	12 小时前
kernels	typo-fix + eof: correct misspellings/rename identifiers (codespell/typos) and fix missing EOF newlines Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1337 merge master into master typo-fix + eof: correct misspellings/rename identifiers (codespell/typos) and fix missing EOF newlines Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhywang Commit-by: zhywang Merged-by: cann-robot Description: 全仓拼写清理 + EOF 换行归一——新增 `typos.toml`（typos 工具配置）扫描源码拼写并据此修正字符串/注释/文档拼写，将拼错的内部标识符（命名空间、include guard、函数/变量名）一并改名；codespell `-L` 白名单扩展领域词；含文件名修正及少量 ruff 无用 import 清理。另补 41 个文件缺失的末行换行（end-of-file-fixer）。`compatiable` 作为外部 CANN-cmake 依赖文件名保留并加白名单。 ## 描述 158 文件 +323/−310，拼写归一，含标识符 rename（非纯格式化）： - 配置：新增 `typos.toml`（领域词/短标识符白名单：nd/cann/subtile/fo/adn/eles/ands/tbe/typ/pn/binar/alog/mis/vitaliy/compatiable、SUBTILE/SUBTILES）；`.pre-commit-config.yaml` 仅扩展 codespell `-L` 白名单（+fo/adn/eles/binar/mis/compatiable），`--skip .py/.cpp/.hpp/.c/.h` 不变（源码拼写由 typos 工具负责）。 - 标识符 rename（内部符号，同文件/编译单元内调用点同步更新）： - 命名空间 `TMatmulInternel`→`TMatmulInternal`、`TCvtInternel`→`TCvtInternal` - include guard `EXTENTION_CSRC_UTILS_H`→`EXTENSION_`、`ELEMENT_TILE_SCLAR_OP_HPP`→`...SCALAR...` - 函数 `ReachExhaused`/`WriteExhaused`→`...Exhausted`、`complate_s32/s16_data`→`complete_` - 变量 `vaild`/`Vaild`→`valid`/`Valid`（77 处，主体）、`fpAddres`→`fpAddress`、`enbleCountMode`→`enableCountMode`、`NeetCntDstIdx`→`NeedCntDstIdx`、`paramter`→`parameter` - 字符串/注释/文档拼写：`convertion`→`conversion`、`Unsupport`→`Unsupported`、`ony`→`only`、`Undelying`→`Underlying`、`Indicies`→`Indices`、`differnent`→`different`、`Iteraions`→`Iterations`、`Simpify`→`Simplify`、`addressess`→`addresses`、`particulary`→`particularly`、`seperate`→`separate`、`accross`→`across`（.md 中英双语同步）。 - 文件名修正：图 `permuate_all2all_count.png`→`permute_all2all_count.png`。 - EOF 换行归一（end-of-file-fixer）：41 个文件补缺失末行 `\n`——本 PR 涉及的 `ElementOp.h`、`tcmp(s)/gen_data.py`、kirinDev0000 5 个 `main.cpp`（10）+ 全仓其余 kirinDev0000 testcases 与 `tinterleave`（31）；多尾随换行 0。 - `compatiable`：外部依赖 `version_compatiable.inc` 路径改名已撤回，改为白名单（须与依赖方拼写一致）。 - ruff：删少量无用 import（`shutil`、`Tuple`）。 ## 关联的Issue ## 测试 - 标识符一致性：各 rename 均在所在文件内同步更新定义与调用点，行为不变。 - 白名单收敛：`typos.toml`/codespell `-L` 已收录全部领域词与外部依赖名，避免误报。 - EOF 验证：全仓复扫缺/多末行换行均 0；`pre-commit run end-of-file-fixer --all-files` Passed（CI 等价）。 - ⚠️ 含标识符 rename（非纯格式化），本机无 CANN/CPU-sim 工具链未做编译/单测；建议可编译环境跑一次 build + 测试复核（重点确认 namespace/guard/`valid` 系列无外部引用残留）。 - 改动量*：158 文件 +323/−310（.cpp 77 / .hpp 34 / .py 24 / .md 9 / .h 7 / .sh 4 / .yaml 1 / .toml 1 / .png 1）。 ## 文档更新 .md 仅修正拼写（中英双语），无内容/结构改动。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他，请描述：全仓拼写清理（codespell/typos 修正拼写、rename 拼错标识符、新增 typos.toml）+ EOF 末行换行归一（end-of-file-fixer，41 文件）；外部依赖名 compatiable 加白名单保留。 See merge request: cann/pto-isa!1337	4 天前
scripts	typo-fix + eof: correct misspellings/rename identifiers (codespell/typos) and fix missing EOF newlines Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1337 merge master into master typo-fix + eof: correct misspellings/rename identifiers (codespell/typos) and fix missing EOF newlines Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhywang Commit-by: zhywang Merged-by: cann-robot Description: 全仓拼写清理 + EOF 换行归一——新增 `typos.toml`（typos 工具配置）扫描源码拼写并据此修正字符串/注释/文档拼写，将拼错的内部标识符（命名空间、include guard、函数/变量名）一并改名；codespell `-L` 白名单扩展领域词；含文件名修正及少量 ruff 无用 import 清理。另补 41 个文件缺失的末行换行（end-of-file-fixer）。`compatiable` 作为外部 CANN-cmake 依赖文件名保留并加白名单。 ## 描述 158 文件 +323/−310，拼写归一，含标识符 rename（非纯格式化）： - 配置：新增 `typos.toml`（领域词/短标识符白名单：nd/cann/subtile/fo/adn/eles/ands/tbe/typ/pn/binar/alog/mis/vitaliy/compatiable、SUBTILE/SUBTILES）；`.pre-commit-config.yaml` 仅扩展 codespell `-L` 白名单（+fo/adn/eles/binar/mis/compatiable），`--skip .py/.cpp/.hpp/.c/.h` 不变（源码拼写由 typos 工具负责）。 - 标识符 rename（内部符号，同文件/编译单元内调用点同步更新）： - 命名空间 `TMatmulInternel`→`TMatmulInternal`、`TCvtInternel`→`TCvtInternal` - include guard `EXTENTION_CSRC_UTILS_H`→`EXTENSION_`、`ELEMENT_TILE_SCLAR_OP_HPP`→`...SCALAR...` - 函数 `ReachExhaused`/`WriteExhaused`→`...Exhausted`、`complate_s32/s16_data`→`complete_` - 变量 `vaild`/`Vaild`→`valid`/`Valid`（77 处，主体）、`fpAddres`→`fpAddress`、`enbleCountMode`→`enableCountMode`、`NeetCntDstIdx`→`NeedCntDstIdx`、`paramter`→`parameter` - 字符串/注释/文档拼写：`convertion`→`conversion`、`Unsupport`→`Unsupported`、`ony`→`only`、`Undelying`→`Underlying`、`Indicies`→`Indices`、`differnent`→`different`、`Iteraions`→`Iterations`、`Simpify`→`Simplify`、`addressess`→`addresses`、`particulary`→`particularly`、`seperate`→`separate`、`accross`→`across`（.md 中英双语同步）。 - 文件名修正：图 `permuate_all2all_count.png`→`permute_all2all_count.png`。 - EOF 换行归一（end-of-file-fixer）：41 个文件补缺失末行 `\n`——本 PR 涉及的 `ElementOp.h`、`tcmp(s)/gen_data.py`、kirinDev0000 5 个 `main.cpp`（10）+ 全仓其余 kirinDev0000 testcases 与 `tinterleave`（31）；多尾随换行 0。 - `compatiable`：外部依赖 `version_compatiable.inc` 路径改名已撤回，改为白名单（须与依赖方拼写一致）。 - ruff：删少量无用 import（`shutil`、`Tuple`）。 ## 关联的Issue ## 测试 - 标识符一致性：各 rename 均在所在文件内同步更新定义与调用点，行为不变。 - 白名单收敛：`typos.toml`/codespell `-L` 已收录全部领域词与外部依赖名，避免误报。 - EOF 验证：全仓复扫缺/多末行换行均 0；`pre-commit run end-of-file-fixer --all-files` Passed（CI 等价）。 - ⚠️ 含标识符 rename（非纯格式化），本机无 CANN/CPU-sim 工具链未做编译/单测；建议可编译环境跑一次 build + 测试复核（重点确认 namespace/guard/`valid` 系列无外部引用残留）。 - 改动量*：158 文件 +323/−310（.cpp 77 / .hpp 34 / .py 24 / .md 9 / .h 7 / .sh 4 / .yaml 1 / .toml 1 / .png 1）。 ## 文档更新 .md 仅修正拼写（中英双语），无内容/结构改动。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他，请描述：全仓拼写清理（codespell/typos 修正拼写、rename 拼错标识符、新增 typos.toml）+ EOF 末行换行归一（end-of-file-fixer，41 文件）；外部依赖名 compatiable 加白名单保留。 See merge request: cann/pto-isa!1337	4 天前
tests	[CPU-SIM] TADDEQRELU impl Co-authored-by: Azizbek<habibov.azizbek@h-partners.com> # message auto-generated for no-merge-commit merge: !1340 merge add into master [CPU-SIM] TADDEQRELU impl Created-by: Azizbek Commit-by: Azizbek Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/pto-isa!1340	12 小时前
.clang-format	Repo-wide pre-commit: reflow all C++ under updated .clang-format and modernize pre-commit/OAT config Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1314 merge master into master Repo-wide pre-commit: reflow all C++ under updated .clang-format and modernize pre-commit/OAT config Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhhywang Commit-by: zhhywang Merged-by: cann-robot Description: 以更新后的 `.clang-format`（核心：`PointerAlignment` Right→Left；另 `AfterEnum` true→false、`AlwaysBreakBeforeMultilineStrings` true→false、`AlignAfterOpenBracket` AlwaysBreak、`AllowShortFunctionsOnASingleLine` false→true）为基准，对全仓 C++（含 `tests/`/`include/`/`kernels/`/`demos/`）做确定性格式化重排；并重写 `.pre-commit-config.yaml`（gitcode 镜像、clang-format v16→v18，新增 ruff/codespell/typos/OAT 全套 hook）、细化 `OAT.xml` 合规策略。不改变任何功能逻辑，全仓无 Python 改动。 ## 描述本次提交为「全仓 C++ 格式化 + pre-commit 工程配置升级」，原则：只做确定性风格重排与配置强化，零逻辑变更。按改动分三类： 1. 全仓 C++ 格式化（主体）：clang-format 重排 1841 个 C++ 文件（.cpp 1273 / .hpp 506 / .h 58 / .cc 4），覆盖 tests(1227)、include(455)、kernels(137)、demos(22)。改动为指针对齐 `Type &x`→`Type& x` 及按新列宽/换行规则的逐行重排；每个删除行均有等价新增行（token 不变），`git diff -w` 验证为纯重排。净行数略减（短函数/紧凑换行合并）。 2. `.pre-commit-config.yaml` 重写：mirror 切换至 gitcode.com；clang-format `v16.0.0`→`v18.1.8`；补齐 pre-commit-hooks（trailing-ws/eof/check-yaml/large-files/merge-conflict/private-key/json）；新增 ruff-check + ruff-format、codespell、typos、本地 oat-check；设 `minimum_pre_commit_version: 4.0.0`、`default_stages:[pre-commit]`；顶层 `exclude` 增 `^(tests\|demos)/.\.py$`。 3. `OAT.xml` 合规策略细化：license policyitem 补 `filefilter`/desc；新增 `<policyitem type="copyright" name="Huawei Technologies Co., Ltd" .../>`（Copyright 噪声下降）；`defaultPolicyFilter` 增配置/图片/二进制文件过滤（xml/yaml/csv/png/so/o/om 等）。 > 说明：本次无任何 Python 文件改动（0 个 `.py`）；codespell hook `--skip .cpp/.hpp/.c/.h`，不检查 C++ 拼写，故全仓 diff 无标识符 rename、无拼写修复、无 `# noqa`。 ## 关联的Issue ## 测试 - pre-commit 全量：trailing-whitespace / end-of-file-fixer / check-yaml / check-added-large-files / check-merge-conflict / detect-private-key / clang-format 等 hook PASS。 - 格式化收敛：抽样文件 `-w` 验证为纯重排（token 等价，无语义变化）。 - ⚠️ 未做编译验证（本机无 CANN 工具链）：格式化不改逻辑；建议在可编译环境跑一次 build 复核。 - 改动量*：1844 文件，+69754 / −80029（主体为格式化重排，净行数略减）。 ## 文档更新无文档内容改动；`.clang-format` 为本仓既有 Allman 规则更新（本次格式化基准）。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：全仓 pre-commit 工程治理——按更新后的 `.clang-format`（`PointerAlignment` Right→Left 等）重排全仓 C++，并重写 `.pre-commit-config.yaml`/细化 `OAT.xml`；无 Python 改动、无逻辑变更。 See merge request: cann/pto-isa!1314	5 天前
.gitignore	lint+license: reformat with ruff/clang-format and normalize CANN OSL v2.0 headers Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1333 merge master into master lint+license: reformat with ruff/clang-format and normalize CANN OSL v2.0 headers Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhywang Commit-by: zhywang Merged-by: cann-robot Description: 全仓 pre-commit 扫描——ruff format/black 与 clang-format 重排代码格式（零逻辑变更），并将源文件 License 头统一归一到 CANN Open Software License v2.0 全文（补缺失头、V1.0 升 V2.0、订正 "under the terms and conditions" 措辞），另补 .gitignore 忽略项。 ## 描述 63 文件 +1753/−1082，两类自动修复，核心无逻辑/语义变更： - License 头归一（→ CANN OSL v2.0 全文）： - 补缺失头：`pyproject.toml`、`kernels/manual/a2a3/dispatch_mega_combine/main.cpp` 等新增标准版权块。 - 升级旧头：`run.sh` 等 "a part of the CANN Open Software / Version 1.0" 短头 → v2.0 全文。 - 订正措辞：`under terms and conditions of` → `under the terms and conditions of`（21 处）。 - 代码格式化（零逻辑）： - Python（54 文件，ruff format/black）：多行函数调用折叠为单行、容器/字符串换行重排（docs/tools、kernels/tests 脚本为主）。 - C++（4 .cpp + 1 .hpp，clang-format）：引用符号 `&`/`` 贴类型、空体函数合并、长参数换行。 - 配置：`.gitignore` 增 `oat_reports/`、`log/`；`setup.py` 补空行。抽样 `docs/tools/normalize_isa_docs.py`、`TPairReduceSum.hpp`、`tests/.../gen_data.py` 均为格式/license 文本变更，无标识符 rename、无代码增删。 ## 关联的Issue ## 测试 - 格式化零逻辑：Python 仅换行重排、C++ 仅 `&` 贴类型与换行；无语句增删、无标识符变化。 - License 合规：新增/升级头文本与仓内既有 v2.0 头一致；OAT 扫描头数应上升。 - ⚠️ 未做编译/单测验证（本机无 CANN/CPU-sim 工具链）；格式化不改语义，建议可编译环境跑一次 build + 测试复核。 - 改动量*：63 文件 +1753/−1082（.py 54 / .cpp 4 / .sh 2 / .hpp 1 / .toml 1 / .gitignore 1）。 ## 文档更新无文档内容改动；仅 License 头文本归一。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他，请描述：全仓 pre-commit 清理——代码格式化（ruff format + clang-format）与 CANN OSL v2.0 License 头归一，零逻辑变更。 See merge request: cann/pto-isa!1333	4 天前
.pre-commit-config.yaml	typo-fix + eof: correct misspellings/rename identifiers (codespell/typos) and fix missing EOF newlines Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1337 merge master into master typo-fix + eof: correct misspellings/rename identifiers (codespell/typos) and fix missing EOF newlines Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhywang Commit-by: zhywang Merged-by: cann-robot Description: 全仓拼写清理 + EOF 换行归一——新增 `typos.toml`（typos 工具配置）扫描源码拼写并据此修正字符串/注释/文档拼写，将拼错的内部标识符（命名空间、include guard、函数/变量名）一并改名；codespell `-L` 白名单扩展领域词；含文件名修正及少量 ruff 无用 import 清理。另补 41 个文件缺失的末行换行（end-of-file-fixer）。`compatiable` 作为外部 CANN-cmake 依赖文件名保留并加白名单。 ## 描述 158 文件 +323/−310，拼写归一，含标识符 rename（非纯格式化）： - 配置：新增 `typos.toml`（领域词/短标识符白名单：nd/cann/subtile/fo/adn/eles/ands/tbe/typ/pn/binar/alog/mis/vitaliy/compatiable、SUBTILE/SUBTILES）；`.pre-commit-config.yaml` 仅扩展 codespell `-L` 白名单（+fo/adn/eles/binar/mis/compatiable），`--skip .py/.cpp/.hpp/.c/.h` 不变（源码拼写由 typos 工具负责）。 - 标识符 rename（内部符号，同文件/编译单元内调用点同步更新）： - 命名空间 `TMatmulInternel`→`TMatmulInternal`、`TCvtInternel`→`TCvtInternal` - include guard `EXTENTION_CSRC_UTILS_H`→`EXTENSION_`、`ELEMENT_TILE_SCLAR_OP_HPP`→`...SCALAR...` - 函数 `ReachExhaused`/`WriteExhaused`→`...Exhausted`、`complate_s32/s16_data`→`complete_` - 变量 `vaild`/`Vaild`→`valid`/`Valid`（77 处，主体）、`fpAddres`→`fpAddress`、`enbleCountMode`→`enableCountMode`、`NeetCntDstIdx`→`NeedCntDstIdx`、`paramter`→`parameter` - 字符串/注释/文档拼写：`convertion`→`conversion`、`Unsupport`→`Unsupported`、`ony`→`only`、`Undelying`→`Underlying`、`Indicies`→`Indices`、`differnent`→`different`、`Iteraions`→`Iterations`、`Simpify`→`Simplify`、`addressess`→`addresses`、`particulary`→`particularly`、`seperate`→`separate`、`accross`→`across`（.md 中英双语同步）。 - 文件名修正：图 `permuate_all2all_count.png`→`permute_all2all_count.png`。 - EOF 换行归一（end-of-file-fixer）：41 个文件补缺失末行 `\n`——本 PR 涉及的 `ElementOp.h`、`tcmp(s)/gen_data.py`、kirinDev0000 5 个 `main.cpp`（10）+ 全仓其余 kirinDev0000 testcases 与 `tinterleave`（31）；多尾随换行 0。 - `compatiable`：外部依赖 `version_compatiable.inc` 路径改名已撤回，改为白名单（须与依赖方拼写一致）。 - ruff：删少量无用 import（`shutil`、`Tuple`）。 ## 关联的Issue ## 测试 - 标识符一致性：各 rename 均在所在文件内同步更新定义与调用点，行为不变。 - 白名单收敛：`typos.toml`/codespell `-L` 已收录全部领域词与外部依赖名，避免误报。 - EOF 验证：全仓复扫缺/多末行换行均 0；`pre-commit run end-of-file-fixer --all-files` Passed（CI 等价）。 - ⚠️ 含标识符 rename（非纯格式化），本机无 CANN/CPU-sim 工具链未做编译/单测；建议可编译环境跑一次 build + 测试复核（重点确认 namespace/guard/`valid` 系列无外部引用残留）。 - 改动量*：158 文件 +323/−310（.cpp 77 / .hpp 34 / .py 24 / .md 9 / .h 7 / .sh 4 / .yaml 1 / .toml 1 / .png 1）。 ## 文档更新 .md 仅修正拼写（中英双语），无内容/结构改动。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他，请描述：全仓拼写清理（codespell/typos 修正拼写、rename 拼错标识符、新增 typos.toml）+ EOF 末行换行归一（end-of-file-fixer，41 文件）；外部依赖名 compatiable 加白名单保留。 See merge request: cann/pto-isa!1337	4 天前
AGENTS.md	mxquant support nv fp8 ,ocp fp4,nv fp4 Co-authored-by: bynshard<zhangbingshuai@huawei.com> # message auto-generated for no-merge-commit merge: !923 merge mxquant-nv into master mxquant support nv fp8 ,ocp fp4,nv fp4 Created-by: bynshard Commit-by: bynshard Merged-by: cann-robot Description: ## 描述 A5 支持 mxquant 新类型，mxfp8 支持 nv 算法， mxfp4 支持 nv 算法和 ocp算法 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/pto-isa!923	2 个月前
CMakeLists.txt	Use FetchContent to reuse CANN engineering common cmake repo Co-authored-by: shengxinchen<chenshengxin@huawei.com> # message auto-generated for no-merge-commit merge: !988 merge feat/use-cann-cmake into master Use FetchContent to reuse CANN engineering common cmake repo Created-by: shengxinchen Commit-by: shengxinchen Merged-by: cann-robot Description: ## 描述本 PR 将 PTO-ISA 组件仓的 cmake/version 接口与 run 包打包流程整体切换到 CANN 工程公共仓 cann/cmake，移除组件仓内重复的版本管理函数、打包脚本与内置 makeself 集成。整个改造由两个 commit 组成。 ## 主要变更 ### Commit 1：cmake/version 接入工程公共仓（e0530842） - 新增 `cmake/fetch_cann_cmake.cmake`，通过 FetchContent 拉取 cann-cmake - `CMakeLists.txt` 改调 `init_cann_project` / `check_cann_pkg_build_deps` / `add_cann_version_info_targets` - `version.cmake` 切到工程仓 API：`set_cann_package` / `set_cann_run_dependencies` - `cmake/func.cmake` 删除重复的 `set_package` / `set_build_dependencies` / `set_run_dependencies` / `check_pkg_build_deps` / `add_version_info_targets` / `replace_cur_major_minor_ver` - 删除 `scripts/check_build_dependencies.py`、`scripts/generate_version_info.py` （由工程仓 `scripts/version/` 提供） ### Commit 2：打包流程切到 set_cann_cpack_config(077d61e0) - `cmake/package.cmake` 改用工程仓提供的 `set_cann_cpack_config(pto-isa …)`， install/cleanup/version 等帮助脚本统一从 `${CANN_CMAKE_DIR}` 引用 - `cmake/fetch_cann_cmake.cmake` 中 `CANN_CMAKE_TAG` 由 master-001 升到 master-017（包含 set_cann_cpack_config 所需修复） - `scripts/package/pto_isa/pto_isa.xml` 新增 `<share_info_name>pto_isa</share_info_name>`，保证生成的 share/info 目录布局正确 - 删除组件仓内重复的打包资产： - `cmake/makeself_built_in.cmake`、`cmake/third_party/makeself-fetch.cmake` - `scripts/package/common/`（py/sh 全部） - `scripts/package/latest_manager/scripts/`（含 manager_func.sh 等） - `scripts/package/package.py` - 同步更新 `cmake/README.md`、`scripts/package/README.md`、`SECURITY.md` ### Commit 3：公共编译选项切换到工程公共仓（200f23eb） - 顶层 `CMakeLists.txt` 在 `init_cann_project()` 之后新增调用 `add_cann_target_options()`，引入工程公共仓 `cann-cmake` 提供的 `intf_pub` INTERFACE target，封装 `-fPIC` / `-Wall` / `-Wextra` / `-fstack-protector-strong`、ASAN/TSAN/UBSAN/GCOV 开关、`-Wl,-z,relro/now/noexecstack` 等公共编译/链接选项 - 组件仓未涉及 device 侧 cmake（无 `cmake/device` 目录、无 `set(PRODUCT_SIDE device)`），按"如果涉及 device 编译再追加"原则本 commit 不在 device 侧追加调用合计：49 files changed, 95 insertions(+), 13841 deletions(-) （commit 1：6 files / +53 / -348；commit 2：42 files / +41 / -13493；commit 3：1 file / +1 / -0） ## 测试 ### Commit 1 `sh build.sh --pkg` 修改前后 staging 产物字节级一致，仅 `version.info` 中 timestamp 行不同（符合预期）。 ### Commit 2 对 commit 1 staging 产物 (`pre.run`) 与 commit 2 staging 产物 (`build_out/cann-pto-isa_9.1.0_linux-aarch64.run`) 做了 run 包级别 diff 与安装流程联调：条件 1：修改前后仅工程脚本差异 — 通过* - `aarch64-linux/` 产品载荷 455 个文件字节级一致 - `version.info` 仅 timestamp 行不同 - 其余差异全部收敛在 `share/info/pto_isa/script/`（即工程仓提供的 install helper），其中 `common_interface.bash` → `common_interface.sh` 为重命名，无外部引用条件 2：安装 / 卸载 / 升级流程 — 通过（升级有既有 bug 已确认非本 PR 引入） \| 用例 \| 结果 \| \| --- \| --- \| \| 新包 `--full` 全新安装 \| 通过，落盘 490 文件 \| \| 旧包 `--full` 全新安装 \| 通过，与新包仅差 `common_interface.{bash↔sh}` \| \| `--uninstall`（新/旧包均测） \| 残留 0 文件 0 目录 \| \| 同版本覆盖安装 \| 通过，自动 uninstall→install \| \| 跨版本卸载（旧装新卸 / 新装旧卸） \| 残留均为 0 \| \| `--upgrade`（旧 → 新） \| 失败：`ERR_NO:0x0002;ERR_DES:Empty paramters is invalid for install.` \| \| `--upgrade` 对照（新→新、旧→旧） \| 同样失败 \| `--upgrade` 失败可在未改动的 `pre.run` 上稳定复现，根因在工程仓 `install.sh` 中 `--upgrade` 分支未给 `IN_INSTALL_TYPE` 回填值（详见 `pto_install.sh` 71-74 行空参拦截），属上游既有问题，不是本 PR 引入的回归，将另起单独修复。 ### Commit 3 对 commit 2 产物（baseline.run）与 commit 3 产物（changed.run）做 run 包级 diff 与安装流程联调：条件 1：修改前后仅工程脚本差异 — 通过 - 同一构建机相邻时刻分别构建 baseline.run / changed.run，解压后 `diff -r` 结果仅 `share/info/pto_isa/version.info` 的 timestamp 行不同，工程脚本与 `aarch64-linux/` 产品载荷字节级一致 - 由于 `intf_pub` 为 INTERFACE target 且当前无 target 链接它，包内容不变符合预期；后续业务 target 通过 `target_link_libraries(<tgt> PRIVATE intf_pub)` 即可继承公共选项条件 2：安装 / 卸载 / 升级流程 — 通过（升级失败与 commit 2 同根因，非本 commit 引入） \| 用例 \| 结果 \| \| --- \| --- \| \| `--full` 全新安装 \| 通过，目录结构、`version.info`、`ascend_install.info` 落盘正常 \| \| `--uninstall` \| 通过，`share/info/pto_isa` 清空，`ascend_install.info` 删除 \| \| `--upgrade` \| 失败：`ERR_NO:0x0002;ERR_DES:Empty paramters is invalid for install.`，在 baseline.run（未含本 commit）上同样稳定复现，与 commit 2 测试段已定位的上游 `install.sh` 既有问题同根因 \| See merge request: cann/pto-isa!988	1 个月前
CONTRIBUTING.md	Refactor the readme and update the implementation status of the instructions Co-authored-by: SherwinBai<baixiaorui1@h-partners.com> # message auto-generated for no-merge-commit merge: !754 merge feature/refactor_readme_clean into master Refactor the readme and update the implementation status of the instructions Created-by: SherwinBai Commit-by: SherwinBai Merged-by: cann-robot Description: ## 描述关键修改: - 重构 `README.md` / `README_zh.md`，优化整体结构、导航信息和项目介绍 - 更新 `CONTRIBUTING.md` / `CONTRIBUTING_zh.md` 增加提交前本地检查pre-commit工具使用说明 - 门户README中文档构建流程下沉到 `docs/mkdocs/README*.md` - 同步并完善 `include/README.md` / `include/README_zh.md` 中的 PTO 指令实现状态表 - 对照 `docs/isa/` 及其子目录补充缺失指令项，并调整状态说明位置与描述 - 同步更新多篇 ISA 文档、相关链接及部分配图内容影响范围: - 仅涉及文档更新 - 不涉及功能逻辑和运行时行为变更 ## 类型标签 - [ ] 文档更新 See merge request: cann/pto-isa!754	3 个月前
CONTRIBUTING_zh.md	Refactor the readme and update the implementation status of the instructions Co-authored-by: SherwinBai<baixiaorui1@h-partners.com> # message auto-generated for no-merge-commit merge: !754 merge feature/refactor_readme_clean into master Refactor the readme and update the implementation status of the instructions Created-by: SherwinBai Commit-by: SherwinBai Merged-by: cann-robot Description: ## 描述关键修改: - 重构 `README.md` / `README_zh.md`，优化整体结构、导航信息和项目介绍 - 更新 `CONTRIBUTING.md` / `CONTRIBUTING_zh.md` 增加提交前本地检查pre-commit工具使用说明 - 门户README中文档构建流程下沉到 `docs/mkdocs/README*.md` - 同步并完善 `include/README.md` / `include/README_zh.md` 中的 PTO 指令实现状态表 - 对照 `docs/isa/` 及其子目录补充缺失指令项，并调整状态说明位置与描述 - 同步更新多篇 ISA 文档、相关链接及部分配图内容影响范围: - 仅涉及文档更新 - 不涉及功能逻辑和运行时行为变更 ## 类型标签 - [ ] 文档更新 See merge request: cann/pto-isa!754	3 个月前
FAQ.md	fix: comprehensive punctuation, spelling, encoding, and C++ portability fixes Co-authored-by: SherwinBai<baixiaorui1@h-partners.com> # message auto-generated for no-merge-commit merge: !979 merge feature/fix-problems into master fix: comprehensive punctuation, spelling, encoding, and C++ portability fixes Created-by: SherwinBai Commit-by: SherwinBai Merged-by: cann-robot Description: ## 概述对仓库进行全面的质量问题修复，涵盖标点符号错误、英文拼写/语法错误、中英文编码乱码、C++ 可移植性问题。 ## 修改内容 ### 新增 FAQ 页面，建立项目常见问题知识库在仓库根目录新增中英文 FAQ 页面，用于记录开发者在 PTO 项目中遇到的常见问题及解决方案，降低重复排查成本。 FAQ.md — 英文版 FAQ_zh.md — 中文版首条收录问题：调试模式（-d）下源码修改不生效 ### 关键 Bug 修复 - [MXTypes.hpp] 修复子正常浮点数转换中 for 循环体后缺少分号的 bug，该错误导致子正常数表示计算在循环体内执行而非循环后执行。 ### 编码乱码修复 - [debug_zh.md] 修复约 430 条断言条目中英文字母被中文字符系统性替换的问题（`in→在`、`or→或`、`to→到`、`and→和`），恢复正确的代码标识符路径。 ### 英文语法/拼写修复（debug.md） - `constructors is` → `constructor is`（4 处） - `32 bytes align` → `32-byte aligned`（3 处） - `mube be` → `must be the same` - `Rigth` → `Right`、`shouuld` → `should` - `ony support` → `only support`（3 处） - `must be must be` → `must be`（6 处，含 TGATHER.md、debug_zh.md） - `GetValidRow()` → `GetValidCol()`（CA-0001 逻辑修复） ### 英文文件中的中文标点修复 - [TTRANS.md]、[TABS.md]、[TGATHER.md]、[GlobalTensor.md]、[complex-ops.md]、matmul README — 中文标点 `：` `，` `。` `、` → 英文标点 `:` `,` `.` `,` - [SKILL.md] — 14 个代码块中的中文标点替换 ### 中文文件修复 - [topk/README_zh.md] — 英文句号 `.` → 中文句号 `。` - [auto_mode/README_zh.md] — `声定义` → `声明定义` - [topk/README.md] — `seperately`→`separately`、`dependece`→`dependence`、`corresonding`→`corresponding` ### C++ 可移植性修复 - `long int`/`long` → `int64_t`：[TBroadcast.hpp]、[TGather.hpp]、[TScatter.hpp]、[TGet.hpp] - `dstSignaData` → `dstSignalData`：[TNotify.hpp] - `CAST_ODD_THRESHHOLD` → `CAST_ODD_THRESHOLD`：[TCvt.hpp] ## 测试计划 - [ ] A2/A3/A5 目标构建验证 - [ ] 运行 `tests/cpu/st/` 模拟器测试确认 MXTypes.hpp 修复正确 - [ ] 抽查 debug.md / debug_zh.md 断言 ID 可读性 - [ ] 检查 TTRANS.md、TGATHER.md 英文格式正确 ## 关联的ISSUE https://gitcode.com/cann/pto-isa/issues/375 ## 类型标签 - [ ] 文档更新 See merge request: cann/pto-isa!979	1 个月前
FAQ_zh.md	fix: comprehensive punctuation, spelling, encoding, and C++ portability fixes Co-authored-by: SherwinBai<baixiaorui1@h-partners.com> # message auto-generated for no-merge-commit merge: !979 merge feature/fix-problems into master fix: comprehensive punctuation, spelling, encoding, and C++ portability fixes Created-by: SherwinBai Commit-by: SherwinBai Merged-by: cann-robot Description: ## 概述对仓库进行全面的质量问题修复，涵盖标点符号错误、英文拼写/语法错误、中英文编码乱码、C++ 可移植性问题。 ## 修改内容 ### 新增 FAQ 页面，建立项目常见问题知识库在仓库根目录新增中英文 FAQ 页面，用于记录开发者在 PTO 项目中遇到的常见问题及解决方案，降低重复排查成本。 FAQ.md — 英文版 FAQ_zh.md — 中文版首条收录问题：调试模式（-d）下源码修改不生效 ### 关键 Bug 修复 - [MXTypes.hpp] 修复子正常浮点数转换中 for 循环体后缺少分号的 bug，该错误导致子正常数表示计算在循环体内执行而非循环后执行。 ### 编码乱码修复 - [debug_zh.md] 修复约 430 条断言条目中英文字母被中文字符系统性替换的问题（`in→在`、`or→或`、`to→到`、`and→和`），恢复正确的代码标识符路径。 ### 英文语法/拼写修复（debug.md） - `constructors is` → `constructor is`（4 处） - `32 bytes align` → `32-byte aligned`（3 处） - `mube be` → `must be the same` - `Rigth` → `Right`、`shouuld` → `should` - `ony support` → `only support`（3 处） - `must be must be` → `must be`（6 处，含 TGATHER.md、debug_zh.md） - `GetValidRow()` → `GetValidCol()`（CA-0001 逻辑修复） ### 英文文件中的中文标点修复 - [TTRANS.md]、[TABS.md]、[TGATHER.md]、[GlobalTensor.md]、[complex-ops.md]、matmul README — 中文标点 `：` `，` `。` `、` → 英文标点 `:` `,` `.` `,` - [SKILL.md] — 14 个代码块中的中文标点替换 ### 中文文件修复 - [topk/README_zh.md] — 英文句号 `.` → 中文句号 `。` - [auto_mode/README_zh.md] — `声定义` → `声明定义` - [topk/README.md] — `seperately`→`separately`、`dependece`→`dependence`、`corresonding`→`corresponding` ### C++ 可移植性修复 - `long int`/`long` → `int64_t`：[TBroadcast.hpp]、[TGather.hpp]、[TScatter.hpp]、[TGet.hpp] - `dstSignaData` → `dstSignalData`：[TNotify.hpp] - `CAST_ODD_THRESHHOLD` → `CAST_ODD_THRESHOLD`：[TCvt.hpp] ## 测试计划 - [ ] A2/A3/A5 目标构建验证 - [ ] 运行 `tests/cpu/st/` 模拟器测试确认 MXTypes.hpp 修复正确 - [ ] 抽查 debug.md / debug_zh.md 断言 ID 可读性 - [ ] 检查 TTRANS.md、TGATHER.md 英文格式正确 ## 关联的ISSUE https://gitcode.com/cann/pto-isa/issues/375 ## 类型标签 - [ ] 文档更新 See merge request: cann/pto-isa!979	1 个月前
LICENSE	origin code Signed-off-by: yujiangtao <yujiangtao11@h-partners.com>	6 个月前
MANIFEST.in	support python package Co-authored-by: zhangjian_hz11<zhjian.zhang@huawei.com> # message auto-generated for no-merge-commit merge: !951 merge pypackage into master support python package Created-by: zhangjian_hz11 Commit-by: zhangjian_hz11 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/pto-isa!951	1 个月前
OAT.xml	Repo-wide pre-commit: reflow all C++ under updated .clang-format and modernize pre-commit/OAT config Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1314 merge master into master Repo-wide pre-commit: reflow all C++ under updated .clang-format and modernize pre-commit/OAT config Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhhywang Commit-by: zhhywang Merged-by: cann-robot Description: 以更新后的 `.clang-format`（核心：`PointerAlignment` Right→Left；另 `AfterEnum` true→false、`AlwaysBreakBeforeMultilineStrings` true→false、`AlignAfterOpenBracket` AlwaysBreak、`AllowShortFunctionsOnASingleLine` false→true）为基准，对全仓 C++（含 `tests/`/`include/`/`kernels/`/`demos/`）做确定性格式化重排；并重写 `.pre-commit-config.yaml`（gitcode 镜像、clang-format v16→v18，新增 ruff/codespell/typos/OAT 全套 hook）、细化 `OAT.xml` 合规策略。不改变任何功能逻辑，全仓无 Python 改动。 ## 描述本次提交为「全仓 C++ 格式化 + pre-commit 工程配置升级」，原则：只做确定性风格重排与配置强化，零逻辑变更。按改动分三类： 1. 全仓 C++ 格式化（主体）：clang-format 重排 1841 个 C++ 文件（.cpp 1273 / .hpp 506 / .h 58 / .cc 4），覆盖 tests(1227)、include(455)、kernels(137)、demos(22)。改动为指针对齐 `Type &x`→`Type& x` 及按新列宽/换行规则的逐行重排；每个删除行均有等价新增行（token 不变），`git diff -w` 验证为纯重排。净行数略减（短函数/紧凑换行合并）。 2. `.pre-commit-config.yaml` 重写：mirror 切换至 gitcode.com；clang-format `v16.0.0`→`v18.1.8`；补齐 pre-commit-hooks（trailing-ws/eof/check-yaml/large-files/merge-conflict/private-key/json）；新增 ruff-check + ruff-format、codespell、typos、本地 oat-check；设 `minimum_pre_commit_version: 4.0.0`、`default_stages:[pre-commit]`；顶层 `exclude` 增 `^(tests\|demos)/.\.py$`。 3. `OAT.xml` 合规策略细化：license policyitem 补 `filefilter`/desc；新增 `<policyitem type="copyright" name="Huawei Technologies Co., Ltd" .../>`（Copyright 噪声下降）；`defaultPolicyFilter` 增配置/图片/二进制文件过滤（xml/yaml/csv/png/so/o/om 等）。 > 说明：本次无任何 Python 文件改动（0 个 `.py`）；codespell hook `--skip .cpp/.hpp/.c/.h`，不检查 C++ 拼写，故全仓 diff 无标识符 rename、无拼写修复、无 `# noqa`。 ## 关联的Issue ## 测试 - pre-commit 全量：trailing-whitespace / end-of-file-fixer / check-yaml / check-added-large-files / check-merge-conflict / detect-private-key / clang-format 等 hook PASS。 - 格式化收敛：抽样文件 `-w` 验证为纯重排（token 等价，无语义变化）。 - ⚠️ 未做编译验证（本机无 CANN 工具链）：格式化不改逻辑；建议在可编译环境跑一次 build 复核。 - 改动量*：1844 文件，+69754 / −80029（主体为格式化重排，净行数略减）。 ## 文档更新无文档内容改动；`.clang-format` 为本仓既有 Allman 规则更新（本次格式化基准）。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：全仓 pre-commit 工程治理——按更新后的 `.clang-format`（`PointerAlignment` Right→Left 等）重排全仓 C++，并重写 `.pre-commit-config.yaml`/细化 `OAT.xml`；无 Python 改动、无逻辑变更。 See merge request: cann/pto-isa!1314	5 天前
README.md	fix: comprehensive punctuation, spelling, encoding, and C++ portability fixes Co-authored-by: SherwinBai<baixiaorui1@h-partners.com> # message auto-generated for no-merge-commit merge: !979 merge feature/fix-problems into master fix: comprehensive punctuation, spelling, encoding, and C++ portability fixes Created-by: SherwinBai Commit-by: SherwinBai Merged-by: cann-robot Description: ## 概述对仓库进行全面的质量问题修复，涵盖标点符号错误、英文拼写/语法错误、中英文编码乱码、C++ 可移植性问题。 ## 修改内容 ### 新增 FAQ 页面，建立项目常见问题知识库在仓库根目录新增中英文 FAQ 页面，用于记录开发者在 PTO 项目中遇到的常见问题及解决方案，降低重复排查成本。 FAQ.md — 英文版 FAQ_zh.md — 中文版首条收录问题：调试模式（-d）下源码修改不生效 ### 关键 Bug 修复 - [MXTypes.hpp] 修复子正常浮点数转换中 for 循环体后缺少分号的 bug，该错误导致子正常数表示计算在循环体内执行而非循环后执行。 ### 编码乱码修复 - [debug_zh.md] 修复约 430 条断言条目中英文字母被中文字符系统性替换的问题（`in→在`、`or→或`、`to→到`、`and→和`），恢复正确的代码标识符路径。 ### 英文语法/拼写修复（debug.md） - `constructors is` → `constructor is`（4 处） - `32 bytes align` → `32-byte aligned`（3 处） - `mube be` → `must be the same` - `Rigth` → `Right`、`shouuld` → `should` - `ony support` → `only support`（3 处） - `must be must be` → `must be`（6 处，含 TGATHER.md、debug_zh.md） - `GetValidRow()` → `GetValidCol()`（CA-0001 逻辑修复） ### 英文文件中的中文标点修复 - [TTRANS.md]、[TABS.md]、[TGATHER.md]、[GlobalTensor.md]、[complex-ops.md]、matmul README — 中文标点 `：` `，` `。` `、` → 英文标点 `:` `,` `.` `,` - [SKILL.md] — 14 个代码块中的中文标点替换 ### 中文文件修复 - [topk/README_zh.md] — 英文句号 `.` → 中文句号 `。` - [auto_mode/README_zh.md] — `声定义` → `声明定义` - [topk/README.md] — `seperately`→`separately`、`dependece`→`dependence`、`corresonding`→`corresponding` ### C++ 可移植性修复 - `long int`/`long` → `int64_t`：[TBroadcast.hpp]、[TGather.hpp]、[TScatter.hpp]、[TGet.hpp] - `dstSignaData` → `dstSignalData`：[TNotify.hpp] - `CAST_ODD_THRESHHOLD` → `CAST_ODD_THRESHOLD`：[TCvt.hpp] ## 测试计划 - [ ] A2/A3/A5 目标构建验证 - [ ] 运行 `tests/cpu/st/` 模拟器测试确认 MXTypes.hpp 修复正确 - [ ] 抽查 debug.md / debug_zh.md 断言 ID 可读性 - [ ] 检查 TTRANS.md、TGATHER.md 英文格式正确 ## 关联的ISSUE https://gitcode.com/cann/pto-isa/issues/375 ## 类型标签 - [ ] 文档更新 See merge request: cann/pto-isa!979	1 个月前
README_zh.md	docs(docs): Fix broken doc-site links and dead PTO-AS references Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1090 merge docs/fix-isa-doc-links into master docs(docs): Fix broken doc-site links and dead PTO-AS references Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: ## Summary - Replace 264 dead PTO-AS spec links in docs/isa/*.md and comm pages with an inline-code reference `docs/grammar/PTO-AS.md`, matching the already-migrated pages; the docs/assembly tree was deleted earlier but the per-instruction back-references were left dangling - Convert root-absolute `/docs/...` links in the hand-written manual pages (01-overview{,_zh}, appendix-d{,_zh}) to repo-relative paths so they resolve in the Gitcode repository file view as well as on the doc site, and fix gen_pages.py REL_LINK_RE so multi-level `../` prefixes are counted correctly by the relative-link rewriter - Repoint the build-guide links from the site-excluded docs/mkdocs/README{,_zh}.md to docs/website{,_zh}.md - Skip the repo-root README.md in gen_pages.py (it collides with the curated homepage index.md) and redirect inbound links to the homepage at build time, leaving the repo-relative source links untouched - Convert a `.py` script link in the flash_atten README to inline code ## Testing - [x] `mkdocs build --strict` passes with 0 warnings (down from 275) - [x] Manual/ISA links verified to resolve in both the rendered doc site and the Gitcode repository file view - [x] Repo-relative source links left intact where the site rewrite is build-time only Closes [#409](https://gitcode.com/cann/pto-isa/issues/409) See merge request: cann/pto-isa!1090	1 个月前
ReleaseNote.md	Refactor the readme and update the implementation status of the instructions Co-authored-by: SherwinBai<baixiaorui1@h-partners.com> # message auto-generated for no-merge-commit merge: !754 merge feature/refactor_readme_clean into master Refactor the readme and update the implementation status of the instructions Created-by: SherwinBai Commit-by: SherwinBai Merged-by: cann-robot Description: ## 描述关键修改: - 重构 `README.md` / `README_zh.md`，优化整体结构、导航信息和项目介绍 - 更新 `CONTRIBUTING.md` / `CONTRIBUTING_zh.md` 增加提交前本地检查pre-commit工具使用说明 - 门户README中文档构建流程下沉到 `docs/mkdocs/README*.md` - 同步并完善 `include/README.md` / `include/README_zh.md` 中的 PTO 指令实现状态表 - 对照 `docs/isa/` 及其子目录补充缺失指令项，并调整状态说明位置与描述 - 同步更新多篇 ISA 文档、相关链接及部分配图内容影响范围: - 仅涉及文档更新 - 不涉及功能逻辑和运行时行为变更 ## 类型标签 - [ ] 文档更新 See merge request: cann/pto-isa!754	3 个月前
ReleaseNote_zh.md	Refactor the readme and update the implementation status of the instructions Co-authored-by: SherwinBai<baixiaorui1@h-partners.com> # message auto-generated for no-merge-commit merge: !754 merge feature/refactor_readme_clean into master Refactor the readme and update the implementation status of the instructions Created-by: SherwinBai Commit-by: SherwinBai Merged-by: cann-robot Description: ## 描述关键修改: - 重构 `README.md` / `README_zh.md`，优化整体结构、导航信息和项目介绍 - 更新 `CONTRIBUTING.md` / `CONTRIBUTING_zh.md` 增加提交前本地检查pre-commit工具使用说明 - 门户README中文档构建流程下沉到 `docs/mkdocs/README*.md` - 同步并完善 `include/README.md` / `include/README_zh.md` 中的 PTO 指令实现状态表 - 对照 `docs/isa/` 及其子目录补充缺失指令项，并调整状态说明位置与描述 - 同步更新多篇 ISA 文档、相关链接及部分配图内容影响范围: - 仅涉及文档更新 - 不涉及功能逻辑和运行时行为变更 ## 类型标签 - [ ] 文档更新 See merge request: cann/pto-isa!754	3 个月前
SECURITY.md	build: upgrade json third-party from v3.11.3 to v3.12.0 Co-authored-by: zoujiangjiang<zoujiangjiang@h-partners.com> # message auto-generated for no-merge-commit merge: !1308 merge upgrade-json-3.11.3-to-3.12.0 into master build: upgrade json third-party from v3.11.3 to v3.12.0 Created-by: zoujiangjiang Commit-by: zoujiangjiang Merged-by: cann-robot Description: ## 关联 Issue Closes #482 ## 变更内容将 cmake/third_party/json.cmake 中 nlohmann/json 第三方依赖的下载版本从 v3.11.3 升级到 v3.12.0。 ## 变更范围仅修改下载 URL 中的版本号，单行改动： - v3.11.3/include.zip -> v3.12.0/include.zip json 为 header-only 依赖，URL 模板与旧版一致，无接口签名/构建逻辑变更。 ## 校验 - 已确认 v3.12.0/include.zip 下载地址有效（ZIP 文件，PK 魔数校验通过）。 See merge request: cann/pto-isa!1308	5 天前
SECURITY_zh.md	Repo-wide pre-commit: strip trailing whitespace and normalize EOF newlines Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1320 merge master into master Repo-wide pre-commit: strip trailing whitespace and normalize EOF newlines Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhhywang Commit-by: zhhywang Merged-by: cann-robot Description: 全仓跑 `trailing-whitespace` + `end-of-file-fixer`：剥离行尾空白、补缺失末行换行、删多余尾随空行；零逻辑/语义变更，覆盖 tests/docs/include/kernels/demos 及 .py/.md/.sh/.js。 ## 描述全仓 pre-commit 自动修复扫描，仅做空白与行尾归一，零逻辑变更： - 行尾空白：剥离行末多余空格/制表符（主体；.cpp/.hpp/.h/.md/.py/.sh/.js 全覆盖）。 - 文件尾换行：补缺失末行换行（多处 `\ No newline at end of file`）、删多余尾随空行，统一单换行结尾。 `git diff -w` 仅余 250 文件（皆为 EOF 换行/空行修复，`-w` 不抑制空行变更），其余 ~903 文件纯行尾空白；逐类抽样（.cpp/.hpp/.py/.md/setup.py/SKILL.md）均为空白归一，无 token 变化。 ## 关联的Issue ## 测试 - 空白归一收敛：`git diff -w --stat` = 250 文件 +46/−365；抽样 `.cpp` 文件 `-w` diff 为空（纯行尾空白）。 - 无逻辑变更：无标识符 rename、无代码增删，仅空白/换行。 - ⚠️ 未做编译验证（本机无 CANN/CPU-sim 工具链）；空白不改语义，建议可编译环境跑一次 build 复核。 - 改动量：1153 文件，+15054 / −15373（.cpp 634 / .md 298 / .hpp 175 / .py 18 / .sh 13 / .h 12 / .js 3）。 ## 文档更新无文档内容改动；.md 仅为行尾空白/EOF 换行归一。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：全仓 pre-commit 空白归一——trailing-whitespace + end-of-file-fixer，清理行尾空白、统一末行换行；零逻辑变更。 See merge request: cann/pto-isa!1320	5 天前
Third_Party_Open_Source_Software_List.yaml	build: upgrade json third-party from v3.11.3 to v3.12.0 Co-authored-by: zoujiangjiang<zoujiangjiang@h-partners.com> # message auto-generated for no-merge-commit merge: !1308 merge upgrade-json-3.11.3-to-3.12.0 into master build: upgrade json third-party from v3.11.3 to v3.12.0 Created-by: zoujiangjiang Commit-by: zoujiangjiang Merged-by: cann-robot Description: ## 关联 Issue Closes #482 ## 变更内容将 cmake/third_party/json.cmake 中 nlohmann/json 第三方依赖的下载版本从 v3.11.3 升级到 v3.12.0。 ## 变更范围仅修改下载 URL 中的版本号，单行改动： - v3.11.3/include.zip -> v3.12.0/include.zip json 为 header-only 依赖，URL 模板与旧版一致，无接口签名/构建逻辑变更。 ## 校验 - 已确认 v3.12.0/include.zip 下载地址有效（ZIP 文件，PK 魔数校验通过）。 See merge request: cann/pto-isa!1308	5 天前
Third_Party_Open_Source_Software_Notice	build: upgrade json third-party from v3.11.3 to v3.12.0 Co-authored-by: zoujiangjiang<zoujiangjiang@h-partners.com> # message auto-generated for no-merge-commit merge: !1308 merge upgrade-json-3.11.3-to-3.12.0 into master build: upgrade json third-party from v3.11.3 to v3.12.0 Created-by: zoujiangjiang Commit-by: zoujiangjiang Merged-by: cann-robot Description: ## 关联 Issue Closes #482 ## 变更内容将 cmake/third_party/json.cmake 中 nlohmann/json 第三方依赖的下载版本从 v3.11.3 升级到 v3.12.0。 ## 变更范围仅修改下载 URL 中的版本号，单行改动： - v3.11.3/include.zip -> v3.12.0/include.zip json 为 header-only 依赖，URL 模板与旧版一致，无接口签名/构建逻辑变更。 ## 校验 - 已确认 v3.12.0/include.zip 下载地址有效（ZIP 文件，PK 魔数校验通过）。 See merge request: cann/pto-isa!1308	5 天前
build.sh	delete gawk Co-authored-by: zoujiangjiang<zoujiangjiang@h-partners.com> # message auto-generated for no-merge-commit merge: !838 merge dev-build into master delete gawk Created-by: zoujiangjiang Commit-by: zoujiangjiang Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 消除gawk相关依赖 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/pto-isa!838	2 个月前
pyproject.toml	lint+license: reformat with ruff/clang-format and normalize CANN OSL v2.0 headers Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1333 merge master into master lint+license: reformat with ruff/clang-format and normalize CANN OSL v2.0 headers Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhywang Commit-by: zhywang Merged-by: cann-robot Description: 全仓 pre-commit 扫描——ruff format/black 与 clang-format 重排代码格式（零逻辑变更），并将源文件 License 头统一归一到 CANN Open Software License v2.0 全文（补缺失头、V1.0 升 V2.0、订正 "under the terms and conditions" 措辞），另补 .gitignore 忽略项。 ## 描述 63 文件 +1753/−1082，两类自动修复，核心无逻辑/语义变更： - License 头归一（→ CANN OSL v2.0 全文）： - 补缺失头：`pyproject.toml`、`kernels/manual/a2a3/dispatch_mega_combine/main.cpp` 等新增标准版权块。 - 升级旧头：`run.sh` 等 "a part of the CANN Open Software / Version 1.0" 短头 → v2.0 全文。 - 订正措辞：`under terms and conditions of` → `under the terms and conditions of`（21 处）。 - 代码格式化（零逻辑）： - Python（54 文件，ruff format/black）：多行函数调用折叠为单行、容器/字符串换行重排（docs/tools、kernels/tests 脚本为主）。 - C++（4 .cpp + 1 .hpp，clang-format）：引用符号 `&`/`` 贴类型、空体函数合并、长参数换行。 - 配置：`.gitignore` 增 `oat_reports/`、`log/`；`setup.py` 补空行。抽样 `docs/tools/normalize_isa_docs.py`、`TPairReduceSum.hpp`、`tests/.../gen_data.py` 均为格式/license 文本变更，无标识符 rename、无代码增删。 ## 关联的Issue ## 测试 - 格式化零逻辑：Python 仅换行重排、C++ 仅 `&` 贴类型与换行；无语句增删、无标识符变化。 - License 合规：新增/升级头文本与仓内既有 v2.0 头一致；OAT 扫描头数应上升。 - ⚠️ 未做编译/单测验证（本机无 CANN/CPU-sim 工具链）；格式化不改语义，建议可编译环境跑一次 build + 测试复核。 - 改动量*：63 文件 +1753/−1082（.py 54 / .cpp 4 / .sh 2 / .hpp 1 / .toml 1 / .gitignore 1）。 ## 文档更新无文档内容改动；仅 License 头文本归一。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他，请描述：全仓 pre-commit 清理——代码格式化（ruff format + clang-format）与 CANN OSL v2.0 License 头归一，零逻辑变更。 See merge request: cann/pto-isa!1333	4 天前
setup.py	lint+license: reformat with ruff/clang-format and normalize CANN OSL v2.0 headers Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1333 merge master into master lint+license: reformat with ruff/clang-format and normalize CANN OSL v2.0 headers Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhywang Commit-by: zhywang Merged-by: cann-robot Description: 全仓 pre-commit 扫描——ruff format/black 与 clang-format 重排代码格式（零逻辑变更），并将源文件 License 头统一归一到 CANN Open Software License v2.0 全文（补缺失头、V1.0 升 V2.0、订正 "under the terms and conditions" 措辞），另补 .gitignore 忽略项。 ## 描述 63 文件 +1753/−1082，两类自动修复，核心无逻辑/语义变更： - License 头归一（→ CANN OSL v2.0 全文）： - 补缺失头：`pyproject.toml`、`kernels/manual/a2a3/dispatch_mega_combine/main.cpp` 等新增标准版权块。 - 升级旧头：`run.sh` 等 "a part of the CANN Open Software / Version 1.0" 短头 → v2.0 全文。 - 订正措辞：`under terms and conditions of` → `under the terms and conditions of`（21 处）。 - 代码格式化（零逻辑）： - Python（54 文件，ruff format/black）：多行函数调用折叠为单行、容器/字符串换行重排（docs/tools、kernels/tests 脚本为主）。 - C++（4 .cpp + 1 .hpp，clang-format）：引用符号 `&`/`` 贴类型、空体函数合并、长参数换行。 - 配置：`.gitignore` 增 `oat_reports/`、`log/`；`setup.py` 补空行。抽样 `docs/tools/normalize_isa_docs.py`、`TPairReduceSum.hpp`、`tests/.../gen_data.py` 均为格式/license 文本变更，无标识符 rename、无代码增删。 ## 关联的Issue ## 测试 - 格式化零逻辑：Python 仅换行重排、C++ 仅 `&` 贴类型与换行；无语句增删、无标识符变化。 - License 合规：新增/升级头文本与仓内既有 v2.0 头一致；OAT 扫描头数应上升。 - ⚠️ 未做编译/单测验证（本机无 CANN/CPU-sim 工具链）；格式化不改语义，建议可编译环境跑一次 build + 测试复核。 - 改动量*：63 文件 +1753/−1082（.py 54 / .cpp 4 / .sh 2 / .hpp 1 / .toml 1 / .gitignore 1）。 ## 文档更新无文档内容改动；仅 License 头文本归一。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他，请描述：全仓 pre-commit 清理——代码格式化（ruff format + clang-format）与 CANN OSL v2.0 License 头归一，零逻辑变更。 See merge request: cann/pto-isa!1333	4 天前
typos.toml	typo-fix + eof: correct misspellings/rename identifiers (codespell/typos) and fix missing EOF newlines Co-authored-by: zhywang<wangzhiyong74@huawei.com> # message auto-generated for no-merge-commit merge: !1337 merge master into master typo-fix + eof: correct misspellings/rename identifiers (codespell/typos) and fix missing EOF newlines Created-by: zhhywang Commit-by: zhywang Merged-by: cann-robot Description: Created-by: zhywang Commit-by: zhywang Merged-by: cann-robot Description: 全仓拼写清理 + EOF 换行归一——新增 `typos.toml`（typos 工具配置）扫描源码拼写并据此修正字符串/注释/文档拼写，将拼错的内部标识符（命名空间、include guard、函数/变量名）一并改名；codespell `-L` 白名单扩展领域词；含文件名修正及少量 ruff 无用 import 清理。另补 41 个文件缺失的末行换行（end-of-file-fixer）。`compatiable` 作为外部 CANN-cmake 依赖文件名保留并加白名单。 ## 描述 158 文件 +323/−310，拼写归一，含标识符 rename（非纯格式化）： - 配置：新增 `typos.toml`（领域词/短标识符白名单：nd/cann/subtile/fo/adn/eles/ands/tbe/typ/pn/binar/alog/mis/vitaliy/compatiable、SUBTILE/SUBTILES）；`.pre-commit-config.yaml` 仅扩展 codespell `-L` 白名单（+fo/adn/eles/binar/mis/compatiable），`--skip .py/.cpp/.hpp/.c/.h` 不变（源码拼写由 typos 工具负责）。 - 标识符 rename（内部符号，同文件/编译单元内调用点同步更新）： - 命名空间 `TMatmulInternel`→`TMatmulInternal`、`TCvtInternel`→`TCvtInternal` - include guard `EXTENTION_CSRC_UTILS_H`→`EXTENSION_`、`ELEMENT_TILE_SCLAR_OP_HPP`→`...SCALAR...` - 函数 `ReachExhaused`/`WriteExhaused`→`...Exhausted`、`complate_s32/s16_data`→`complete_` - 变量 `vaild`/`Vaild`→`valid`/`Valid`（77 处，主体）、`fpAddres`→`fpAddress`、`enbleCountMode`→`enableCountMode`、`NeetCntDstIdx`→`NeedCntDstIdx`、`paramter`→`parameter` - 字符串/注释/文档拼写：`convertion`→`conversion`、`Unsupport`→`Unsupported`、`ony`→`only`、`Undelying`→`Underlying`、`Indicies`→`Indices`、`differnent`→`different`、`Iteraions`→`Iterations`、`Simpify`→`Simplify`、`addressess`→`addresses`、`particulary`→`particularly`、`seperate`→`separate`、`accross`→`across`（.md 中英双语同步）。 - 文件名修正：图 `permuate_all2all_count.png`→`permute_all2all_count.png`。 - EOF 换行归一（end-of-file-fixer）：41 个文件补缺失末行 `\n`——本 PR 涉及的 `ElementOp.h`、`tcmp(s)/gen_data.py`、kirinDev0000 5 个 `main.cpp`（10）+ 全仓其余 kirinDev0000 testcases 与 `tinterleave`（31）；多尾随换行 0。 - `compatiable`：外部依赖 `version_compatiable.inc` 路径改名已撤回，改为白名单（须与依赖方拼写一致）。 - ruff：删少量无用 import（`shutil`、`Tuple`）。 ## 关联的Issue ## 测试 - 标识符一致性：各 rename 均在所在文件内同步更新定义与调用点，行为不变。 - 白名单收敛：`typos.toml`/codespell `-L` 已收录全部领域词与外部依赖名，避免误报。 - EOF 验证：全仓复扫缺/多末行换行均 0；`pre-commit run end-of-file-fixer --all-files` Passed（CI 等价）。 - ⚠️ 含标识符 rename（非纯格式化），本机无 CANN/CPU-sim 工具链未做编译/单测；建议可编译环境跑一次 build + 测试复核（重点确认 namespace/guard/`valid` 系列无外部引用残留）。 - 改动量*：158 文件 +323/−310（.cpp 77 / .hpp 34 / .py 24 / .md 9 / .h 7 / .sh 4 / .yaml 1 / .toml 1 / .png 1）。 ## 文档更新 .md 仅修正拼写（中英双语），无内容/结构改动。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [x] 其他，请描述：全仓拼写清理（codespell/typos 修正拼写、rename 拼错标识符、新增 typos.toml）+ EOF 末行换行归一（end-of-file-fixer，41 文件）；外部依赖名 compatiable 加白名单保留。 See merge request: cann/pto-isa!1337	4 天前
version.cmake	Use FetchContent to reuse CANN engineering common cmake repo Co-authored-by: shengxinchen<chenshengxin@huawei.com> # message auto-generated for no-merge-commit merge: !988 merge feat/use-cann-cmake into master Use FetchContent to reuse CANN engineering common cmake repo Created-by: shengxinchen Commit-by: shengxinchen Merged-by: cann-robot Description: ## 描述本 PR 将 PTO-ISA 组件仓的 cmake/version 接口与 run 包打包流程整体切换到 CANN 工程公共仓 cann/cmake，移除组件仓内重复的版本管理函数、打包脚本与内置 makeself 集成。整个改造由两个 commit 组成。 ## 主要变更 ### Commit 1：cmake/version 接入工程公共仓（e0530842） - 新增 `cmake/fetch_cann_cmake.cmake`，通过 FetchContent 拉取 cann-cmake - `CMakeLists.txt` 改调 `init_cann_project` / `check_cann_pkg_build_deps` / `add_cann_version_info_targets` - `version.cmake` 切到工程仓 API：`set_cann_package` / `set_cann_run_dependencies` - `cmake/func.cmake` 删除重复的 `set_package` / `set_build_dependencies` / `set_run_dependencies` / `check_pkg_build_deps` / `add_version_info_targets` / `replace_cur_major_minor_ver` - 删除 `scripts/check_build_dependencies.py`、`scripts/generate_version_info.py` （由工程仓 `scripts/version/` 提供） ### Commit 2：打包流程切到 set_cann_cpack_config(077d61e0) - `cmake/package.cmake` 改用工程仓提供的 `set_cann_cpack_config(pto-isa …)`， install/cleanup/version 等帮助脚本统一从 `${CANN_CMAKE_DIR}` 引用 - `cmake/fetch_cann_cmake.cmake` 中 `CANN_CMAKE_TAG` 由 master-001 升到 master-017（包含 set_cann_cpack_config 所需修复） - `scripts/package/pto_isa/pto_isa.xml` 新增 `<share_info_name>pto_isa</share_info_name>`，保证生成的 share/info 目录布局正确 - 删除组件仓内重复的打包资产： - `cmake/makeself_built_in.cmake`、`cmake/third_party/makeself-fetch.cmake` - `scripts/package/common/`（py/sh 全部） - `scripts/package/latest_manager/scripts/`（含 manager_func.sh 等） - `scripts/package/package.py` - 同步更新 `cmake/README.md`、`scripts/package/README.md`、`SECURITY.md` ### Commit 3：公共编译选项切换到工程公共仓（200f23eb） - 顶层 `CMakeLists.txt` 在 `init_cann_project()` 之后新增调用 `add_cann_target_options()`，引入工程公共仓 `cann-cmake` 提供的 `intf_pub` INTERFACE target，封装 `-fPIC` / `-Wall` / `-Wextra` / `-fstack-protector-strong`、ASAN/TSAN/UBSAN/GCOV 开关、`-Wl,-z,relro/now/noexecstack` 等公共编译/链接选项 - 组件仓未涉及 device 侧 cmake（无 `cmake/device` 目录、无 `set(PRODUCT_SIDE device)`），按"如果涉及 device 编译再追加"原则本 commit 不在 device 侧追加调用合计：49 files changed, 95 insertions(+), 13841 deletions(-) （commit 1：6 files / +53 / -348；commit 2：42 files / +41 / -13493；commit 3：1 file / +1 / -0） ## 测试 ### Commit 1 `sh build.sh --pkg` 修改前后 staging 产物字节级一致，仅 `version.info` 中 timestamp 行不同（符合预期）。 ### Commit 2 对 commit 1 staging 产物 (`pre.run`) 与 commit 2 staging 产物 (`build_out/cann-pto-isa_9.1.0_linux-aarch64.run`) 做了 run 包级别 diff 与安装流程联调：条件 1：修改前后仅工程脚本差异 — 通过* - `aarch64-linux/` 产品载荷 455 个文件字节级一致 - `version.info` 仅 timestamp 行不同 - 其余差异全部收敛在 `share/info/pto_isa/script/`（即工程仓提供的 install helper），其中 `common_interface.bash` → `common_interface.sh` 为重命名，无外部引用条件 2：安装 / 卸载 / 升级流程 — 通过（升级有既有 bug 已确认非本 PR 引入） \| 用例 \| 结果 \| \| --- \| --- \| \| 新包 `--full` 全新安装 \| 通过，落盘 490 文件 \| \| 旧包 `--full` 全新安装 \| 通过，与新包仅差 `common_interface.{bash↔sh}` \| \| `--uninstall`（新/旧包均测） \| 残留 0 文件 0 目录 \| \| 同版本覆盖安装 \| 通过，自动 uninstall→install \| \| 跨版本卸载（旧装新卸 / 新装旧卸） \| 残留均为 0 \| \| `--upgrade`（旧 → 新） \| 失败：`ERR_NO:0x0002;ERR_DES:Empty paramters is invalid for install.` \| \| `--upgrade` 对照（新→新、旧→旧） \| 同样失败 \| `--upgrade` 失败可在未改动的 `pre.run` 上稳定复现，根因在工程仓 `install.sh` 中 `--upgrade` 分支未给 `IN_INSTALL_TYPE` 回填值（详见 `pto_install.sh` 71-74 行空参拦截），属上游既有问题，不是本 PR 引入的回归，将另起单独修复。 ### Commit 3 对 commit 2 产物（baseline.run）与 commit 3 产物（changed.run）做 run 包级 diff 与安装流程联调：条件 1：修改前后仅工程脚本差异 — 通过 - 同一构建机相邻时刻分别构建 baseline.run / changed.run，解压后 `diff -r` 结果仅 `share/info/pto_isa/version.info` 的 timestamp 行不同，工程脚本与 `aarch64-linux/` 产品载荷字节级一致 - 由于 `intf_pub` 为 INTERFACE target 且当前无 target 链接它，包内容不变符合预期；后续业务 target 通过 `target_link_libraries(<tgt> PRIVATE intf_pub)` 即可继承公共选项条件 2：安装 / 卸载 / 升级流程 — 通过（升级失败与 commit 2 同根因，非本 commit 引入） \| 用例 \| 结果 \| \| --- \| --- \| \| `--full` 全新安装 \| 通过，目录结构、`version.info`、`ascend_install.info` 落盘正常 \| \| `--uninstall` \| 通过，`share/info/pto_isa` 清空，`ascend_install.info` 删除 \| \| `--upgrade` \| 失败：`ERR_NO:0x0002;ERR_DES:Empty paramters is invalid for install.`，在 baseline.run（未含本 commit）上同样稳定复现，与 commit 2 测试段已定位的上游 `install.sh` 既有问题同根因 \| See merge request: cann/pto-isa!988	1 个月前

PTO Tile Lib

PTO Tile Library

PTO（Parallel Tile Operation）是昇腾 CANN 定义的一套面向 tile 编程的虚拟 ISA。本仓库提供 PTO Tile 指令的实现、示例、测试与文档，帮助开发者在不同昇腾代际之间更平滑地迁移和优化算子。

📰 新闻

🎉 2025-12-27：PTO Tile Library 正式开源发布。
✨ 2026-01-30：新增合轴类指令、MX 指令。
🚀 2026-02-28：新增卷积类指令、量化类指令、核间通信类指令。
🔥 2026-03-30：支持昇腾 A5 芯片，新增异步通信指令、CostModel 性能仿真。
🛠️ 2026-04-02：本地工程链路进一步完善，补充了 pre-commit 检查、文档构建校验与 CPU-SIM 验证能力。

🎯 项目定位

PTO ISA 基于昇腾底层硬件与软件抽象，定义 90+ 条标准 tile 指令，用更高层的 tile 编程模型桥接不同代际之间的实现差异。它的目标不是隐藏底层能力，而是在提升抽象层级的同时保留性能调优空间。

统一跨代 tile 抽象：降低不同 Ascend 代际之间的迁移成本。
兼顾可移植性与性能：在固定 tile shape 下保证正确工作，同时保留 tile size、tile shape、指令顺序等调优能力。
面向框架、算子与工具链：可作为上层框架、算子实现和编译工具链的共同接口。
支持持续扩展：当前已定义 90+ 条标准操作，并持续补充实现与生态集成。

除计算与数据搬运指令外，PTO ISA 还提供了面向 NPU 间数据传输与同步的通信扩展指令集，覆盖点对点通信、信号同步和集合通信三类能力。

这些通信原语延续了与计算指令一致的 tile 级抽象和跨平台设计，并可驱动昇腾上的多种数据搬移硬件引擎，帮助用户构建计算与通信深度融合的 kernel。通信 ISA 入口见 docs/isa/comm/README_zh.md。

目前，PTO 指令已集成到以下框架中：

PyPTO
TileLang Ascend
更多语言与前端持续完善中

✨ 核心特性

统一的 Tile ISA 抽象：用标准 PTO 指令描述 tile 级计算与数据流。
跨代迁移与性能调优兼顾：既提升可移植性，也保留足够的底层控制能力。
Auto / Manual 双模式开发路径：先快速验证逻辑，再逐步深入优化实现。当前 Auto Mode 主要可用于 CPU 仿真。
CPU Simulator 支持：支持在 CPU 上进行功能验证与开发调试。
覆盖关键编程要素：支持 tile shape、tile mask、事件同步、固定功能单元与流水线建模。
文档、测试、示例齐全：提供 ISA 文档、开发文档、测试脚本和性能案例。

👥 适用人群

PTO Tile Lib 主要面向以下开发者：

直接对接昇腾硬件的框架或编译器后端开发者
需要跨平台迁移与复用实现的高性能算子开发者
需要显式控制 tile、buffer 与 pipeline 的性能优化工程师

🚀 快速开始

环境准备

CPU 路径：需要 Python、CMake 和支持 C++20 的编译器，适合跨平台快速验证。
NPU 路径：需要 Linux 环境与 Ascend CANN toolkit，适合在昇腾硬件或模拟器上运行。
更详细的环境部署说明请参见：快速开始指南

编译与运行

# CPU Simulator（建议第一步）
python3 tests/run_cpu.py --clean --verbose

# 运行 GEMM demo
python3 tests/run_cpu.py --demo gemm --verbose

# 运行 Flash Attention demo
python3 tests/run_cpu.py --demo flash_attn --verbose

# 运行单个 ST 用例
python3 tests/script/run_st.py -r sim -v a3 -t tadd -g TADDTest.case_float_64x64_64x64

# 一键构建并运行推荐测试
./build.sh --run_all --a3 --sim

# 在代码根目录下打 whl 包，产物位于 dist/ 目录
python3 -m build --wheel

更完整的构建、测试和脚本说明请参见：快速开始指南、测试说明

🗂️ 文档导航

ISA 与编程模型

ISA 总览：PTO ISA 文档入口与阅读导航
PTO 指令列表：按指令分类查看 PTO 标准操作
Tile 编程模型：理解 tile 的形状、mask 与编程模型
事件与同步：理解事件记录、等待与同步方式
通用约定：查看命名、约束与通用规则

开发与优化

开发文档索引：查看扩展 PTO Tile Lib 的开发文档
性能优化：查看性能分析与调优建议
文档构建说明：查看 MkDocs 文档的本地构建方式

📊 示例与性能参考

GEMM

参考实现：kernels/manual/a2a3/gemm_performance/
详细分析与调参说明：高性能 GEMM 算子示例

GEMM 性能参考（Ascend A3，24 核）

Flash Attention

算子实现与调优说明：A2/A3 版本，A5 版本
A5 构建说明（A5 性能数据待补充）：Flash Attention Performance Kernel (A5)
S0：query 序列长度（Q/O 的行数）
S1：key/value 序列长度（K/V 的行数）

Ascend 910B2 多核对比，基线为 torch_npu：

序列长度	PTO 时间 (us)	torch_npu 时间 (us)	PTO TFLOPS	torch_npu TFLOPS	PTO 加速比
1024	20.960	58.461	25.61	9.18	2.79x
2048	32.461	70.801	66.16	30.33	2.18x
4096	88.902	118.302	96.62	72.61	1.33x
8192	292.626	353.147	117.42	97.30	1.21x
16384	909.058	1118.462	151.19	122.88	1.23x
32768	3262.645	3646.173	168.50	150.78	1.12x

Flash Attention 910B2 PTO vs torch_npu

通信指令带宽

参考实现：kernels/manual/a2a3/tget_bandwidth/
详细分析与构建运行说明：TGET / TGET_ASYNC 带宽对比示例

该示例在 Ascend A2/A3 上测量点对点远程读带宽，对比 TGET（同步，经 UB 中转）与 TGET_ASYNC（异步，经 DMA 引擎直接传输）的表现。

GEMM AllReduce 通算融合

参考实现：kernels/manual/a2a3/gemm_ar/
详细分析与调参说明：高性能 GEMM AllReduce 融合算子示例

该示例展示了如何在同一个算子流水线中融合 PTO 通信原语与计算 kernel，实现 GEMM 与 AllReduce 的重叠执行。

🖥️ 平台支持

Ascend A2（Ascend 910B）
Ascend A3（Ascend 910C）
Ascend A5（Ascend 950）
CPU（x86_64 / AArch64）

更多细节请参考 include/README_zh.md。

🛣️ 路线图

未来计划发布的特性：

功能	描述	范围	进度 / 完成时间
PTO Auto Mode	BiSheng 编译器支持：自动分配 tile buffer 并插入同步。	编译器 / 工具链	持续演进
PTO Tile Fusion	BiSheng 编译器支持：自动融合 tile 操作。	编译器 / 工具链	持续演进
PTO-AS	PTO ISA 的字节码（Byte Code）支持。	编译器 / 工具链	持续演进
卷积扩展	PTO ISA 对卷积 kernel 的支持。	ISA 扩展	持续演进
集合通信扩展	新增支持 Ccu 及 Roce 异步通信指令，新增 TPREFECTH（AIV 直驱）通信指令。	通信 ISA 扩展	2026 Q2
系统调度扩展	PTO ISA 对 SPMD/MPMD 编程的调度支持。	ISA 扩展	规划中
微指令	支持用户通过微指令表达高性能算子，同时提供基础的高性能微指令库。	ISA 扩展 / 算子开发	2026 Q2
基础指令	进一步优化 A5 指令性能，新增 Pooling 相关基础指令，并增强卷积、量化、Fixpipe 类指令能力。	ISA 扩展	2026 Q2
CostModel	支持 A5 指令的 CostModel 性能仿真。	工具链 / 性能建模	2026 Q2
CPU-SIM	CPU-SIM 随指令增强同步构建。	CPU 仿真	2026 Q2

🗃️ 目录结构

关键目录如下：

├── include/                     # PTO 对外头文件与接口
│   └── pto/                     # 公共类型、ISA 接口、CPU/NPU 实现
├── kernels/                     # kernel 与算子实现
│   ├── manual/                  # 手工优化实现与性能示例
│   └── custom/                  # 自定义算子示例
├── docs/                        # ISA、编程模型、快速开始与文档站点源文件
│   ├── isa/                     # 指令参考与分类索引
│   ├── coding/                  # 开发与性能优化文档
│   ├── assembly/                # PTO-AS 汇编语法与规范
│   └── mkdocs/                  # MkDocs 文档构建配置与源文件
├── demos/                       # Auto Mode、baseline 与 torch_jit 示例
├── tests/                       # CPU / NPU 测试、脚本与测试入口
│   ├── cpu/                     # CPU 仿真测试
│   ├── npu/                     # 按 SoC 拆分的 NPU 测试
│   └── script/                  # 测试构建与运行脚本
├── scripts/                     # 构建、安装与发布脚本
├── cmake/                       # CMake 公共配置与打包逻辑
├── build.sh                     # 一键构建与运行入口脚本
└── CMakeLists.txt               # 顶层 CMake 配置

ℹ️ 相关信息

贡献指南：参与项目开发与提交流程
安全与漏洞披露：安全问题反馈流程
版本说明：版本更新与发布记录
许可证：CANN Open Software License Agreement Version 2.0
PyPTO：PTO 生态中的上层编程框架
PTOAS：面向 PTO 工作流的汇编器与编译后端
pto-dsl：面向 PTO 的 Python 前端与 JIT 工作流探索
FAQ：常见问题与解决方案

📬 联系我们

问题反馈：通过仓库 Issues 提交问题
功能建议：通过仓库 Issues 或讨论区反馈需求
贡献代码：通过 Pull Request 参与项目贡献

项目介绍

Others C++1.01 K提交数深度学习

定制我的领域

README

规则集

pto-isa:基于昇腾CANN的tile指令高性能实现与工具链项目