| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
[Feat] add aclgraph introduction in docs Co-authored-by: zhiweihai_00958272<zhiweihai@huawei.com> # message auto-generated for no-merge-commit merge: !3106 merge aclgraphDocs into master [Feat] add aclgraph introduction in docs Created-by: Helmar Commit-by: zhiweihai_00958272 Merged-by: cann-robot Description: ## 描述 本次 PR 在 docs/zh/aclgraph/ 和 docs/en/aclgraph/ 下新增 ACL Graph（NPU 侧图捕获—重放机制）的完整技术文档（中英双语）及配套示例代码，并在 examples/02_aclgraphs/ 下新增 AllReduce 算子 ACL Graph 模式示例。具体改动如下： **1. 新增 ACL Graph 介绍文档（中英双语）** - docs/zh/aclgraph/aclgraph_introduction.md（中文版） - docs/en/aclgraph/aclgraph_introduction.md（英文版，runtime 文档链接引用 Ascend 官网英文版） 系统阐述 ACL Graph 的核心机制，覆盖：§1 ACL Graph 定位与适用范围、§2 捕获生命周期（4 步 API 流程 + 捕获前准备 + 跨流捕获约束 + 同步原语选型 + replay/销毁顺序）、§3 任务更新（原地更新 vs 重新捕获选型）、§4 已知失败模式与规避（启动期/捕获期/释放期）、§5 多 stream 拓扑（HCCL 内部控制面/数据面拆分），以及附录 A 关键 API 速查表、附录 B torch_npu 源码对接路径。文档中所有公开仓链接已逐一验证有效。 **2. 新增 5 张架构流程图** - aclgraph_cross_stream_capture.png（跨流捕获基本流程） - aclgraph_inplace_task_update.png（原地更新任务流程） - aclgraph_recapture_tasks.png（重新捕获任务流程） - aclgraph_concurrent_task_update.png（并发执行场景任务更新流程） - multi_streams_in_aclgraph.png（多 stream 拓扑全景） **3. 新增 AllReduce 算子 ACL Graph 模式示例代码** - examples/02_aclgraphs/allreduce_aclgraph_demo.cpp：原生 ACL + HCCL C API 实现，对应文档 §2.1 四步生命周期（CaptureBegin → HcclAllReduce → CaptureEnd → 多次 ExecuteAsync），已通过 clang-format v18.1.8 格式化。 - examples/02_aclgraphs/allreduce_aclgraph_demo.py：torch_npu.NPUGraph + torch.distributed(hccl) 实现，用 with torch.npu.graph(g): 上下文捕获计算 + dist.all_reduce，g.replay() 多次重放。 **改动原因**：ACL Graph 是 HCCL 通信在图模式下性能优化的关键机制，此前仓库缺少面向开发者的系统性文档。 ## 变更类型 请选择本次引入的变更类型： - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] 🚀 性能优化 - [x] 📝 文档更新 - [ ] 📋 其他，请描述： ## 关联的Issue NA ## 测试 无（纯文档变更，不涉及代码逻辑）。 补充的UT用例： 无（纯文档变更，不涉及代码逻辑）。 ## 文档更新 本次 PR 本身即为文档更新： - 新增 docs/zh/aclgraph/aclgraph_introduction.md（中文版 ACL Graph 完整技术文档） - 新增 docs/en/aclgraph/aclgraph_introduction.md（英文版 ACL Graph 完整技术文档） - 新增 examples/02_aclgraphs/allreduce_aclgraph_demo.cpp（C++ 示例） - 新增 examples/02_aclgraphs/allreduce_aclgraph_demo.py（Python 示例） ## 合入检查 - [ ] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 - [ ] 🔍 邀请 committer评论/lgtm前的必要检查 - [ ] 🏷️ 标题中使用了合适的类型标签（如：[feat], [fix]） - [x] 📄 代码修改内容已简要描述，相关文档已更新 - [x] 📝 代码注释已更新，代码遵循项目整体代码风格 - [x] 🧪 代码UT测试已更新，覆盖率已达标 - [x] 🔬 验证方法已更新到"测试"部分 - [x] 🛠️ 代码已通过静态分析工具检查，无错误 - [ ] 👥 代码检视/code review/同行评议和必要的代码串讲，确保代码质量 - [ ] ✅ 代码检视意见已处理或答复，无未处理的检视意见 - [ ] 🚀 预约 前冒烟 用例前的必要检查 - [ ] ✔️ 代码已有committer的/lgtm 和 模块committer的/lgtm评论 - [x] 🔧 代码已通过compile，编译无错误，无告警 - [x] 🖥️ 代码已通过基本功能本地测试或者在线测试，确保基本功能正常 - [ ] 🎯 预约 approver评论/approve，正式合入前的必要检查 - [ ] 📊 前冒烟 用例已全量通过 - [ ] 📦 新增功能已同步补充基本功能测试用例到前冒烟里 ## 其他信息 - 英文版文档中引用的 runtime 开发指南链接指向 Ascend 官网英文版（hiascend.com），而非 gitcode 中文版 - 附录 B 中 torch_npu 源码链接指向 github.com/Ascend/pytorch（原 Ascend/torch_npu 仓已更名为 Ascend/pytorch） - 源码行号已与 master 分支最新代码核对 See merge request: cann/hcomm!3106 | 1 个月前 | |
【modify docs】添加architecture文件夹下内容的英文，修改样例参考readme中的产品名称 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !5650 merge master into master 【modify docs】添加architecture文件夹下内容的英文，修改样例参考readme中的产品名称 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1、为docs/zh/architecture增加英文文档 2、修改样例readme中的产品型号名称 ## 变更类型 请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] 🚀 性能优化 - [x] 📝 文档更新 - [ ] 📋 其他，请描述： ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> 已完成的测试用例和场景： 1. 2. 补充的UT用例： ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 合入检查 <!-- 在正式合入前，请做好必要的代码测试，用例补充，软件代码风格检查等。提高合入效率。--> <!-- [x] 表示选中 --> - [ ] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 - [ ] 🔍 邀请 committer评论 /lgtm前的必要检查 - [ ] 🏷️ 标题中使用了合适的类型标签（如：[feat], [fix]） - [ ] 📄 代码修改内容已简要描述，相关文档已更新 - [ ] 📝 代码注释已更新，代码遵循项目整体代码风格 - [ ] 🧪 代码UT测试已更新，覆盖率已达标 - [ ] 🔬 验证方法已更新到"测试"部分 - [ ] 🛠️ 代码已通过静态分析工具检查，无错误 - [ ] 👥 代码检视/code review/同行评议和必要的代码串讲，确保代码质量 - [ ] ✅ 代码检视意见已处理或答复，无未处理的检视意见 - [ ] 🚀 预约 前冒烟 用例前的必要检查 - [ ] ✔️ 代码已有committer的/lgtm 和 模块committer的/lgtm评论 - [ ] 🔧 代码已通过compile，编译无错误，无告警 - [ ] 🖥️ 代码已通过基本功能本地测试或者在线测试，确保基本功能正常 - [ ] 🎯 预约 approver评论/approve，正式合入前的必要检查 - [ ] 📊 前冒烟 用例已全量通过 - [ ] 📦 新增功能已同步补充基本功能测试用例到前冒烟里 See merge request: cann/hcomm!5650 | 12 天前 | |
【modify docs】添加architecture文件夹下内容的英文，修改样例参考readme中的产品名称 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !5650 merge master into master 【modify docs】添加architecture文件夹下内容的英文，修改样例参考readme中的产品名称 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1、为docs/zh/architecture增加英文文档 2、修改样例readme中的产品型号名称 ## 变更类型 请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] 🚀 性能优化 - [x] 📝 文档更新 - [ ] 📋 其他，请描述： ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> 已完成的测试用例和场景： 1. 2. 补充的UT用例： ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 合入检查 <!-- 在正式合入前，请做好必要的代码测试，用例补充，软件代码风格检查等。提高合入效率。--> <!-- [x] 表示选中 --> - [ ] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 - [ ] 🔍 邀请 committer评论 /lgtm前的必要检查 - [ ] 🏷️ 标题中使用了合适的类型标签（如：[feat], [fix]） - [ ] 📄 代码修改内容已简要描述，相关文档已更新 - [ ] 📝 代码注释已更新，代码遵循项目整体代码风格 - [ ] 🧪 代码UT测试已更新，覆盖率已达标 - [ ] 🔬 验证方法已更新到"测试"部分 - [ ] 🛠️ 代码已通过静态分析工具检查，无错误 - [ ] 👥 代码检视/code review/同行评议和必要的代码串讲，确保代码质量 - [ ] ✅ 代码检视意见已处理或答复，无未处理的检视意见 - [ ] 🚀 预约 前冒烟 用例前的必要检查 - [ ] ✔️ 代码已有committer的/lgtm 和 模块committer的/lgtm评论 - [ ] 🔧 代码已通过compile，编译无错误，无告警 - [ ] 🖥️ 代码已通过基本功能本地测试或者在线测试，确保基本功能正常 - [ ] 🎯 预约 approver评论/approve，正式合入前的必要检查 - [ ] 📊 前冒烟 用例已全量通过 - [ ] 📦 新增功能已同步补充基本功能测试用例到前冒烟里 See merge request: cann/hcomm!5650 | 12 天前 | |
【modify docs】添加architecture文件夹下内容的英文，修改样例参考readme中的产品名称 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !5650 merge master into master 【modify docs】添加architecture文件夹下内容的英文，修改样例参考readme中的产品名称 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1、为docs/zh/architecture增加英文文档 2、修改样例readme中的产品型号名称 ## 变更类型 请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] 🚀 性能优化 - [x] 📝 文档更新 - [ ] 📋 其他，请描述： ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> 已完成的测试用例和场景： 1. 2. 补充的UT用例： ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 合入检查 <!-- 在正式合入前，请做好必要的代码测试，用例补充，软件代码风格检查等。提高合入效率。--> <!-- [x] 表示选中 --> - [ ] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 - [ ] 🔍 邀请 committer评论 /lgtm前的必要检查 - [ ] 🏷️ 标题中使用了合适的类型标签（如：[feat], [fix]） - [ ] 📄 代码修改内容已简要描述，相关文档已更新 - [ ] 📝 代码注释已更新，代码遵循项目整体代码风格 - [ ] 🧪 代码UT测试已更新，覆盖率已达标 - [ ] 🔬 验证方法已更新到"测试"部分 - [ ] 🛠️ 代码已通过静态分析工具检查，无错误 - [ ] 👥 代码检视/code review/同行评议和必要的代码串讲，确保代码质量 - [ ] ✅ 代码检视意见已处理或答复，无未处理的检视意见 - [ ] 🚀 预约 前冒烟 用例前的必要检查 - [ ] ✔️ 代码已有committer的/lgtm 和 模块committer的/lgtm评论 - [ ] 🔧 代码已通过compile，编译无错误，无告警 - [ ] 🖥️ 代码已通过基本功能本地测试或者在线测试，确保基本功能正常 - [ ] 🎯 预约 approver评论/approve，正式合入前的必要检查 - [ ] 📊 前冒烟 用例已全量通过 - [ ] 📦 新增功能已同步补充基本功能测试用例到前冒烟里 See merge request: cann/hcomm!5650 | 12 天前 | |
[fix] 修正EI0020端口冲突处置指引 (#987) Co-authored-by: ren-mengguang<renmengguang@h-partners.com> # message auto-generated for no-merge-commit merge: !5725 merge fix/ei0020-port-conflict-guide into master [fix] 修正EI0020端口冲突处置指引 (#987) Created-by: ren-mengguang Commit-by: ren-mengguang Merged-by: cann-robot Description: ## 描述 EI0020（NPU网卡socket监听端口bind冲突）当前的处置指引只给出"单卡多进程场景配置HCCL_NPU_SOCKET_PORT_RANGE"一条路径，未区分通信域初始化方式： - rootInfo方式初始化：该环境变量生效（ServerInitAll→PreemptPortManager在范围内抢占端口并回填分发），指引正确； - rank table文件方式初始化：无端口抢占逻辑，该环境变量不生效，按现有指引操作无法解决问题。正确处置是每个进程使用的rank table文件中为同一device_ip的rank配置互不相同的device_port/host_port（字段缺省时默认16666，单卡多进程场景冲突）。 本PR修改： 1. EI0020中英文错误码文档：解决方法按初始化路线区分； 2. error_code.cc注册表Solution：同步修正，对齐仓内EI0002/EI0005惯例（简短分条建议+关键字检索引导），保证错误管理框架通道与文档一致。 ## 变更类型 - [x] 🐛 Bug修复 - [x] 📝 文档更新 ## 关联的Issue Fixes #987 ## 测试 已完成的测试用例和场景： 1. clang-format 18.1.8（与pre-commit同版本）--dry-run -Werror 校验通过； 2. hcomm目标（含error_code.cc）编译链接通过，无告警（基线为upstream/master最新）； 3. error_code.cc注册表JSON提取后json.loads校验合法（\r\n、引号转义正确）。 说明：本机全量build.sh --pkg因存量工具链问题无法完成（hccl_aiv_reduce_scatter_op，CANN 9.2.0头文件类型错误，干净工作区同样复现，与本次改动无关），改动文件所在目标已单独编译验证，完整编译由CI门禁覆盖。 补充的UT用例： 无（纯文案修正，无行为变更）。 ## 文档更新 - docs/zh/error_codes/EI0020-Communication_Error_Bind_IP_Port.md - docs/en/error_codes/EI0020-Communication_Error_Bind_IP_Port.md ## 合入检查 - [x] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定 - [x] 🔍 邀请 committer评论 /lgtm前的必要检查 - [x] 🏷️ 标题中使用了合适的类型标签（[fix]） - [x] 📄 代码修改内容已简要描述，相关文档已更新 - [x] 📝 代码注释已更新，代码遵循项目整体代码风格 - [x] 🧪 代码UT测试已更新，覆盖率已达标（本次无行为变更，无需新增UT） - [x] 🔬 验证方法已更新到"测试"部分 - [x] 🛠️ 代码已通过静态分析工具检查，无错误 See merge request: cann/hcomm!5725 | 6 天前 | |
[docs] Reserve RFC number for HCCLang （PR #923） Co-authored-by: kookgi<1325259269@qq.com> # message auto-generated for no-merge-commit merge: !5473 merge master into master [docs] Reserve RFC number for HCCLang （PR #923） Created-by: kookgi Commit-by: kookgi Merged-by: cann-robot Description: ## 描述 本次 PR 用于为 HCCLang RFC 预留 RFC 编号。 计划提交 RFC，该 RFC 主要面向集合通信与通信计算融合场景，设计 HCCLang 集合通信及内存语义 DSL。本次 PR 主要更新 RFC 登记索引并预留编号，同时补充英文 RFC INDEX 中缺失的 0002 Host NIC Plugin Mechanism 登记项，以保持中英文索引一致。后续将单独提交完整 RFC 文档进行方案评审。 ## 变更类型 请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] 🚀 性能优化 - [x] 📝 文档更新 - [ ] 📋 其他，请描述： ## 关联的Issue [#923](https://gitcode.com/cann/hcomm/issues/923) ## 测试 已完成的测试用例和场景： 1. NA 2. NA 补充的UT用例： NA，本次 PR 仅涉及 RFC 索引文档更新。 ## 文档更新 更新 RFC INDEX.md： 1. 新增 HCCLang RFC 0003 登记项，并将状态设置为 reserved； 2. 同步补充 docs/en/rfcs/INDEX.md 中缺失的 RFC 0002 Host NIC Plugin Mechanism 登记项，使中英文 RFC 索引保持一致。 ## 合入检查 - [x] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 - [ ] 🔍 邀请 committer评论/lgtm前的必要检查 - [x] 🏷️ 标题中使用了合适的类型标签（如：[feat], [fix]） - [x] 📄 代码修改内容已简要描述，相关文档已更新 - [ ] 📝 代码注释已更新，代码遵循项目整体代码风格 - [ ] 🧪 代码UT测试已更新，覆盖率已达标 - [x] 🔬 验证方法已更新到"测试"部分 - [ ] 🛠️ 代码已通过静态分析工具检查，无错误 - [ ] 👥 代码检视/code review/同行评议和必要的代码串讲，确保代码质量 - [ ] ✅ 代码检视意见已处理或答复，无未处理的检视意见 - [ ] 🚀 预约 前冒烟 用例前的必要检查 - [ ] ✔️ 代码已有committer的/lgtm 和 模块committer的/lgtm评论 - [ ] 🔧 代码已通过compile，编译无错误，无告警 - [ ] 🖥️ 代码已通过基本功能本地测试或者在线测试，确保基本功能正常 - [ ] 🎯 预约 approver评论/approve，正式合入前的必要检查 - [ ] 📊 前冒烟 用例已全量通过 - [ ] 📦 新增功能已同步补充基本功能测试用例到前冒烟里 See merge request: cann/hcomm!5473 | 12 天前 |
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 1 个月前 | ||
| 12 天前 | ||
| 12 天前 | ||
| 12 天前 | ||
| 6 天前 | ||
| 12 天前 |