集合通信库（Huawei Collective Communication Library，简称HCCL）是基于昇腾AI处理器的高性能集合通信库，为计算集群提供高性能、高可靠的通信方案
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
设置冒烟任务执行分支和超时时间 Co-authored-by: wangchuang616<wangchuang12@huawei.com> # message auto-generated for no-merge-commit merge: !2344 merge master into master 设置冒烟任务执行分支和超时时间 Created-by: wangchuang616 Commit-by: wangchuang616 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2344 | 1 个月前 | |
[build] add_cann_sign_file 使用 VERSION 参数并清理冗余 VERSION_INFO 传递 Co-authored-by: zhaoyingdong<zhaoyingdong@huawei.com> # message auto-generated for no-merge-commit merge: !2313 merge master into master [build] add_cann_sign_file 使用 VERSION 参数并清理冗余 VERSION_INFO 传递 Created-by: zhaoyingdong Commit-by: zhaoyingdong Merged-by: cann-robot Description: ## 描述 [build] add_cann_sign_file 使用 VERSION 参数并清理冗余 VERSION_INFO 传递 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2313 | 1 个月前 | |
【fix docs】文档优化，补充章节简介 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !2506 merge master into master 【fix docs】文档优化，补充章节简介 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 文档优化。 针对只有一级标题的md文件补充简介 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2506 | 28 天前 | |
[build] format all C/C++ files Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2496 merge build/clang-format into master [build] format all C/C++ files Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. format all C/C++ files ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> 1. 编译通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2496 | 1 个月前 | |
[build] format all C/C++ files Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2496 merge build/clang-format into master [build] format all C/C++ files Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. format all C/C++ files ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> 1. 编译通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2496 | 1 个月前 | |
[build] format all C/C++ files Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2496 merge build/clang-format into master [build] format all C/C++ files Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. format all C/C++ files ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> 1. 编译通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2496 | 1 个月前 | |
【fix】 修复pre-commit的oat在执行时的异常 Co-authored-by: zhangfands<18768316492@163.com> # message auto-generated for no-merge-commit merge: !2501 merge master into master 【fix】 修复pre-commit的oat在执行时的异常 Created-by: zhangfands Commit-by: zhangfands Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 修复pre-commit的oat在执行cmd时异常报错 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> 其他仓已部署一段时间 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2501 | 1 个月前 | |
[feat]: add CcuEventGroup to fix >16p mask truncation Co-authored-by: zhongyu1<zhongyu37@huawei.com> # message auto-generated for no-merge-commit merge: !2383 merge broadcast_cleangroup into master [feat]: add CcuEventGroup to fix >16p mask truncation Created-by: zhongyu1 Commit-by: zhongyu1 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ccu broadcast和alltoall的同步信号使用多个event，适配16p以上，并封装了EventGroup ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2383 | 28 天前 | |
HCCL order Launch Co-authored-by: wangyujiang98<wangyujiang3@h-partners.com> # message auto-generated for no-merge-commit merge: !2030 merge Test2607 into master HCCL order Launch Created-by: wangyujiang98 Commit-by: wangyujiang98 Merged-by: cann-robot Description: ## 描述 本提交为 HCCL 通信算子新增 **按序下发(Order Launch)** 功能，确保 AICPU 通信算子在多通信域场景下按序执行，避免因通信域数量大于核数时的并发执行乱序问题。同时新增 RAII event 资源管理、dlsym 支持检查等机制。 主要改动如下： 1. **新增 order_launch.h / order_launch.cc**：实现按序下发两阶段核心逻辑。 - 定义 OrderLaunchMode 枚举（ORDER_LAUNCH_OPBASE / ORDER_LAUNCH_ACLGRAPH / ORDER_LAUNCH_GE），统一三种启动模式入口。 - 新增 HcclRtEventGuard RAII 类：封装 ACL event 的创建（Create()）与析构时自动销毁，禁止拷贝，保证所有退出路径（含 CHK_RET 早退）不泄漏 event 资源。 - HcclOrderLaunchToOrderStream（第一阶段）：获取 Host 侧保序流并导出到 Device 侧通信引擎，获取 Device 侧保序流，通过 notify 建立流间同步；ACLGRAPH 模式额外通过 event 建立 unfoldStream 与 hostOrderStream 间的依赖；不支持 HcclDedicatedThreadAcquire 或通信域数 < 核数时优雅降级。 - HcclOrderLaunchToKernelStream（第二阶段）：Host 侧保序流等待第一阶段 record 的 notify 完成同步；ACLGRAPH 模式额外通过 event 建立 hostOrderStream 与 unfoldStream 间的反向依赖；同样具备降级路径。 - GetOrderLaunchHostThreadType 函数完整覆盖三种模式，分别映射到 HCCL_DED_THREAD_TYPE_AICPU_ORDER_LAUNCH_OPBASE（=2）、HCCL_DED_THREAD_TYPE_AICPU_ORDER_LAUNCH_ACLGRAPH（=3）、HCCL_DED_THREAD_TYPE_AICPU_ORDER_LAUNCH_GE（=4）专用线程类型。 2. **alg_param.h**： - 新增按序下发所需的 notify 索引/数量常量（ORDER_UNFOLD_THREAD_NOTIFY_IDX、ORDER_UNFOLD_THREAD_NOTIFY_NUM、HOST_ORDER_THREAD_NOTIFY_IDX、HOST_ORDER_THREAD_NOTIFY_NUM、DEVICE_ORDER_THREAD_NOTIFY_NUM）。 - 在 OpParam 结构体中新增 exportHostOrderThread（= 0）和 deviceOrderThread（= 0）两个字段，位于 varData[0] 之前，保证柔性数组成员仍为结构体末尾成员。 3. **op_common.cc**： - 新增 #include "exec_timeout_manager.h" 和 #include "order_launch.h"。 - 在 HcclAicpuKernelEntranceLaunch 中集成 Order Launch 第一阶段（kernel launch 前）和第二阶段（kernel launch 后），使用 HcclRtEventGuard 管理 ACLGRAPH 模式下的 event 生命周期；根据 param.isCapture 和 param.opMode 自动选择 ORDER_LAUNCH_ACLGRAPH / ORDER_LAUNCH_GE / ORDER_LAUNCH_OPBASE 模式。 - 将 unfoldThread 的 notify 数量从 0 改为 ORDER_UNFOLD_THREAD_NOTIFY_NUM（路径 A 和路径 B 两处），为按序下发提供 notify 资源。 4. **hccl_res_dl.cc / hccl_res_dl.h**： - 新增 HcclDedicatedThreadType 枚举定义（含 HCCL_DED_THREAD_TYPE_AICPU_ORDER_LAUNCH_OPBASE/ACLGRAPH/GE/DEVICE 等 6 个枚举值，数值与 HCOMM 权威定义一致）。 - 新增 HcclDedicatedThreadAcquire 弱符号函数声明（DECL_WEAK_FUNC）、桩定义（DEFINE_WEAK_FUNC）和 dlsym 支持标志初始化（INIT_SUPPORT_FLAG），遵循 HCCL 与 HCOMM 解耦的 dlsym 架构约束。 5. **dlhcomm_function.cc / dlhcomm_function.h**：新增 dlHcommThreadResGetInfo 动态加载函数，用于通过 Host 侧保序线程句柄获取对应的 stream。 6. **kernel_launch.cc**：在 HcclLaunchAicpuKernel 中新增按序下发 notify record 逻辑——Device 侧保序流向 Host 侧导出保序流 record notify；增加零值保护，保序流未启用时（exportHostOrderThread == 0 || deviceOrderThread == 0）跳过 notify record。 7. **CMakeLists.txt**：将 order_launch.cc 加入编译源文件列表。 8. **测试桩文件**： - hccl_depends_stub.cc：新增 HcclDedicatedThreadAcquire 强符号桩函数，ST 仿真时设置 *thread = 0 触发"OrderLaunch not required"降级路径。 - aclrt_stub.cc：新增 aclrtCreateEventExWithFlag、aclrtDestroyEvent、aclrtRecordEvent、aclrtStreamWaitEvent 桩函数，ST 仿真时返回成功，满足链接需求。 ## 关联的Issue NA ## 测试 - 新增 ST 仿真桩函数，确保 HcclDedicatedThreadAcquire 在仿真环境下返回 0 触发"OrderLaunch not required"降级路径，验证非保序场景的兼容性。 - 新增 ACL event 相关桩函数，验证 ACLGRAPH 模式下 event 创建/销毁/record/wait 在仿真环境的编译与运行。 - 通过二级冒烟测试验证 OPBASE / ACLGRAPH / GE 三种模式下 Order Launch 两阶段流程的正确性。 - 验证 HcclRtEventGuard RAII 机制在正常返回和 CHK_RET 早退路径下均不泄漏 event 资源。 ## 文档更新 NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2030 | 30 天前 | |
[build] update clang-format and pre-commit-config Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2389 merge build/clang-format into master [build] update clang-format and pre-commit-config Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. update clang-format and pre-commit-config ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> 已完成的测试用例和场景： 1. 编译通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程构建 See merge request: cann/hccl!2389 | 1 个月前 | |
add hccl user guide Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !736 merge master into master add hccl user guide Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 新增HCCL用户指南 ## 关联的Issue NA ## 测试 新增文档，需要全量测试 ## 文档更新 docs目录下手册结构调整 新增usr_guide 修改api ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!736 | 3 个月前 | |
[build] format all C/C++ files Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2496 merge build/clang-format into master [build] format all C/C++ files Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. format all C/C++ files ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> 1. 编译通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2496 | 1 个月前 | |
modify docs Co-authored-by: Leewis<liwei945@huawei.com> # message auto-generated for no-merge-commit merge: !2020 merge master into master modify docs Created-by: Leewis Commit-by: Leewis Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 补充950算子展开模式；agent.md中增补文档编写规范 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> https://gitcode.com/cann/hccl/issues/216 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2020 | 1 个月前 | |
A5A6AIV兼容性适配 Co-authored-by: shirokawa_<jinliuyi@huawei.com> # message auto-generated for no-merge-commit merge: !2085 merge A5A6AIV into master A5A6AIV兼容性适配 Created-by: shirokawa_ Commit-by: shirokawa_ Merged-by: cann-robot Description: ## 描述 A5A6AIV兼容性适配 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2085 | 1 个月前 | |
【2026 HCCL通信库创新大赛-西部赛区】【降临派】docs: 修正 CONTRIBUTING.md 中“现在Issue列表中查询”表述 Co-authored-by: 2301_81769094<ziconglu@foxmail.com> # message auto-generated for no-merge-commit merge: !1795 merge docs/fix-contributing-wording-230 into master 【2026 HCCL通信库创新大赛-西部赛区】【降临派】docs: 修正 CONTRIBUTING.md 中“现在Issue列表中查询”表述 Created-by: 2301_81769094 Commit-by: 2301_81769094 Merged-by: cann-robot Description: ## 描述 本次修改针对 CONTRIBUTING.md 中“简单问题处理”章节的文档表述问题进行修正。 原文为： 现在Issue列表中查询该问题是否有对应的Issue； 结合上下文，该步骤语义应为“先在 Issue 列表中查询该问题是否有对应的 Issue”，当前表述存在歧义，语句不够通顺，可能影响读者对贡献流程的理解。 本次将其修正为： 先在Issue列表中查询该问题是否有对应的Issue； 本次修改仅涉及文档文字调整，不涉及代码逻辑、接口或功能行为变化。 补充说明：本PR为“2026 HCCL通信库创新大赛”西部赛区特别贡献奖提交，队名：降临派。 ## 关联的Issue https://gitcode.com/cann/hccl/issues/230 ## 测试 本次为纯文档表述修正，未涉及代码逻辑变更，无需执行功能性测试。 已结合 CONTRIBUTING.md 上下文检查修改前后语义，确认修改后表述更准确、通顺，符合该流程步骤的实际含义。 ## 文档更新 更新了 CONTRIBUTING.md 文件中“简单问题处理”章节的表述。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!1795 | 1 个月前 | |
[fix docs]新增英文文档 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !1696 merge master into master [fix docs]新增英文文档 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 新增英文文档，暂未包含以下目录： docs/zh/api_ref docs/zh/user_guide docs/zh/architecture ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!1696 | 2 个月前 | |
子包适配 Co-authored-by: tianmingL<liutianming2@h-partners.com> | 7 个月前 | |
[build] format all C/C++ files Co-authored-by: ouyangcaike<ouyangcaike@h-partners.com> # message auto-generated for no-merge-commit merge: !2496 merge build/clang-format into master [build] format all C/C++ files Created-by: ouyangcaike Commit-by: ouyangcaike Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. format all C/C++ files ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> 1. 编译通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：工程 See merge request: cann/hccl!2496 | 1 个月前 | |
【2026 HCCL通信库创新大赛-华北赛区】【嘻嘻嘻】docs: 补齐 examples 与根 README 目录索引 Co-authored-by: 陈浩瑜<2035146937@qq.com> # message auto-generated for no-merge-commit merge: !1789 merge fix/docs-readme-indexes into master 【2026 HCCL通信库创新大赛-华北赛区】【嘻嘻嘻】docs: 补齐 examples 与根 README 目录索引 Created-by: weixin_73017041 Commit-by: 陈浩瑜 Merged-by: cann-robot Description: ## 描述 本 PR 修复 2 处 README 索引与实际目录结构不一致的问题： 1. examples/README.md、examples/README_en.md 是 HCCL 样例代码总索引，但原文只列到 04_custom_ops_p2p，漏列实际存在且已有独立说明文档的 05_custom_ops_allgather 自定义 AllGather 样例目录。本次补充自定义集合通信算子章节，并增加 05_custom_ops_allgather 入口。 2. 根目录 README.md、README_en.md 的 src/ops 目录树漏列实际存在并参与构建的 barrier 和 interface_graph_mode 目录。本次在中英文目录树中补充这两个目录。 ## 变更类型 请选择本次引入的变更类型： - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] 🚀 性能优化 - [x] 📝 文档更新 - [ ] 📋 其他，请描述： ## 关联的Issue 关联Issue: #232 相关Issue: #233 ## 测试 已完成的测试用例和场景： 1. 核对 examples/05_custom_ops_allgather/README.md 与 README_en.md 均存在。 2. 核对 src/ops/barrier、src/ops/interface_graph_mode 目录均存在。 3. 核对 src/ops/CMakeLists.txt 已包含 add_subdirectory(interface_graph_mode) 和 add_subdirectory(barrier)。 4. 执行 git diff --check，未发现空白格式错误。 补充的UT用例： 不涉及。本 PR 仅补充 README 文档索引，不改变源码逻辑。 ## 文档更新 更新以下文档： - examples/README.md - examples/README_en.md - README.md - README_en.md ## 合入检查 - [x] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 - [x] 🔍 邀请 committer评论/lgtm前的必要检查 - [x] 🏷️ 标题中使用了合适的类型标签（如：[feat], [fix]） - [x] 📄 代码修改内容已简要描述，相关文档已更新 - [x] 📝 代码注释已更新，代码遵循项目整体代码风格（不涉及代码注释） - [x] 🧪 代码UT测试已更新，覆盖率已达标（仅文档变更，不涉及UT） - [x] 🔬 验证方法已更新到"测试"部分 - [x] 🛠️ 代码已通过静态分析工具检查，无错误（已执行 git diff --check） - [ ] 👥 代码检视/code review/同行评议和必要的代码串讲，确保代码质量 - [ ] ✅ 代码检视意见已处理或答复，无未处理的检视意见 - [ ] 🚀 预约 前冒烟 用例前的必要检查 - [ ] ✔️ 代码已有committer的/lgtm 和 模块committer的/lgtm评论 - [ ] 🔧 代码已通过compile，编译无错误，无告警 - [ ] 🖥️ 代码已通过基本功能本地测试或者在线测试，确保基本功能正常 - [ ] 🎯 预约 approver评论/approve，正式合入前的必要检查 - [ ] 📊 前冒烟 用例已全量通过 - [ ] 📦 新增功能已同步补充基本功能测试用例到前冒烟里 See merge request: cann/hccl!1789 | 1 个月前 | |
【2026 HCCL通信库创新大赛-华北赛区】【嘻嘻嘻】docs: 补齐 examples 与根 README 目录索引 Co-authored-by: 陈浩瑜<2035146937@qq.com> # message auto-generated for no-merge-commit merge: !1789 merge fix/docs-readme-indexes into master 【2026 HCCL通信库创新大赛-华北赛区】【嘻嘻嘻】docs: 补齐 examples 与根 README 目录索引 Created-by: weixin_73017041 Commit-by: 陈浩瑜 Merged-by: cann-robot Description: ## 描述 本 PR 修复 2 处 README 索引与实际目录结构不一致的问题： 1. examples/README.md、examples/README_en.md 是 HCCL 样例代码总索引，但原文只列到 04_custom_ops_p2p，漏列实际存在且已有独立说明文档的 05_custom_ops_allgather 自定义 AllGather 样例目录。本次补充自定义集合通信算子章节，并增加 05_custom_ops_allgather 入口。 2. 根目录 README.md、README_en.md 的 src/ops 目录树漏列实际存在并参与构建的 barrier 和 interface_graph_mode 目录。本次在中英文目录树中补充这两个目录。 ## 变更类型 请选择本次引入的变更类型： - [ ] 🐛 Bug修复 - [ ] ✨ 新特性 - [ ] 🚀 性能优化 - [x] 📝 文档更新 - [ ] 📋 其他，请描述： ## 关联的Issue 关联Issue: #232 相关Issue: #233 ## 测试 已完成的测试用例和场景： 1. 核对 examples/05_custom_ops_allgather/README.md 与 README_en.md 均存在。 2. 核对 src/ops/barrier、src/ops/interface_graph_mode 目录均存在。 3. 核对 src/ops/CMakeLists.txt 已包含 add_subdirectory(interface_graph_mode) 和 add_subdirectory(barrier)。 4. 执行 git diff --check，未发现空白格式错误。 补充的UT用例： 不涉及。本 PR 仅补充 README 文档索引，不改变源码逻辑。 ## 文档更新 更新以下文档： - examples/README.md - examples/README_en.md - README.md - README_en.md ## 合入检查 - [x] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 - [x] 🔍 邀请 committer评论/lgtm前的必要检查 - [x] 🏷️ 标题中使用了合适的类型标签（如：[feat], [fix]） - [x] 📄 代码修改内容已简要描述，相关文档已更新 - [x] 📝 代码注释已更新，代码遵循项目整体代码风格（不涉及代码注释） - [x] 🧪 代码UT测试已更新，覆盖率已达标（仅文档变更，不涉及UT） - [x] 🔬 验证方法已更新到"测试"部分 - [x] 🛠️ 代码已通过静态分析工具检查，无错误（已执行 git diff --check） - [ ] 👥 代码检视/code review/同行评议和必要的代码串讲，确保代码质量 - [ ] ✅ 代码检视意见已处理或答复，无未处理的检视意见 - [ ] 🚀 预约 前冒烟 用例前的必要检查 - [ ] ✔️ 代码已有committer的/lgtm 和 模块committer的/lgtm评论 - [ ] 🔧 代码已通过compile，编译无错误，无告警 - [ ] 🖥️ 代码已通过基本功能本地测试或者在线测试，确保基本功能正常 - [ ] 🎯 预约 approver评论/approve，正式合入前的必要检查 - [ ] 📊 前冒烟 用例已全量通过 - [ ] 📦 新增功能已同步补充基本功能测试用例到前冒烟里 See merge request: cann/hccl!1789 | 1 个月前 | |
[fix docs]新增英文文档 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !1696 merge master into master [fix docs]新增英文文档 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 新增英文文档，暂未包含以下目录： docs/zh/api_ref docs/zh/user_guide docs/zh/architecture ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!1696 | 2 个月前 | |
[fix docs]新增英文文档 Co-authored-by: zangyan<zangyan@huawei.com> # message auto-generated for no-merge-commit merge: !1696 merge master into master [fix docs]新增英文文档 Created-by: flyswa Commit-by: zangyan Merged-by: cann-robot Description: ## 描述 新增英文文档，暂未包含以下目录： docs/zh/api_ref docs/zh/user_guide docs/zh/architecture ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!1696 | 2 个月前 | |
[Build] Add support for offline compile Co-authored-by: jiyuanhao<jiyuanhao1@huawei.com> # message auto-generated for no-merge-commit merge: !126 merge build/third_party into master [Build] Add support for offline compile Created-by: jiyuanhao Commit-by: jiyuanhao Merged-by: cann-robot Description: ## 描述 支持离线编译 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #123--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!126 | 6 个月前 | |
init code | 9 个月前 | |
A5A6AIV兼容性适配 Co-authored-by: shirokawa_<jinliuyi@huawei.com> # message auto-generated for no-merge-commit merge: !2085 merge A5A6AIV into master A5A6AIV兼容性适配 Created-by: shirokawa_ Commit-by: shirokawa_ Merged-by: cann-robot Description: ## 描述 A5A6AIV兼容性适配 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2085 | 1 个月前 | |
[Build] 升级版本号为 9.2.0 Co-authored-by: jiyuanhao<jiyuanhao1@huawei.com> # message auto-generated for no-merge-commit merge: !2402 merge build/9.2.0 into master [Build] 升级版本号为 9.2.0 Created-by: jiyuanhao Commit-by: jiyuanhao Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> [Build] 升级版本号为 9.2.0 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR不涉及Issue，可填写"NA"。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于构造对应xx测试用例、二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/hccl!2402 | 1 个月前 |
HCCL
🔥Latest News
- [2026/05] Ascend950 通信算子支持静态库，详见Issue#90，Issue#105
- [2026/04] Ascend950 通信算子支持图模式，详见PR#613, PR#340, PR#296, GE PR#1620
- [2026/03] Ascend950 通信算子支持AIV&AICPU通信引擎（单算子）
- [2025/11/30] HCCL项目正式开源。
🚀 概述
集合通信库（Huawei Collective Communication Library，简称HCCL）是基于昇腾AI处理器的高性能集合通信库，为计算集群提供高性能、高可靠的通信方案，具备以下核心功能：
- 提供单机、多机环境中的高性能集合通信和点对点通信。
- 支持AllReduce、Broadcast、AllGather、ReduceScatter、AlltoAll等集合通信原语。
- 支持Ring、Mesh、Recursive Halving-Doubling（RHD）等通信算法。
- 支持HCCS、RoCE、PCIe等高速通信链路。
- 支持单算子和图模式两种执行模式。
HCCL是CANN的核心组件，对上支持多种AI框架，对下使能多款昇腾AI处理器之间的通信能力，其软件架构如下图所示：
HCCL包含HCCL集合通信库与HCOMM（Huawei Communication）通信基础库：
- HCCL集合通信库：包含内置通信算子和扩展通信算子，提供对外的通信算子接口。
- HCOMM通信基础库：采用分层解耦的设计思路，将通信能力划分为控制面和数据面两部分。
🔍 目录结构说明
本项目关键目录如下所示：
│── src # HCCL算子源码目录
| ├── common # 通用逻辑，包括类型定义、日志模块等
| └── ops # HCCL算子实现
| ├── all_gather # AllGather算子实现
| ├── all_gather_v # AllGatherV算子实现
| ├── all_reduce # AllReduce算子实现
| ├── all_to_all_v # AlltoAll、AlltoAllV、AlltoAllVC算子实现
| ├── barrier # Barrier算子实现
| ├── batch_send_recv # BatchSendRecv算子实现
| ├── broadcast # Broadcast算子实现
| ├── interface_graph_mode # 图模式接口实现
| ├── op_common # 算子通用组件
| │ ├── executor # 执行器
| │ ├── selector # 算法选择器
| │ ├── template # 算法模板
| │ └── topo # 通信域拓扑信息获取和转换
| ├── recv # Recv算子实现
| ├── reduce # Reduce算子实现
| ├── reduce_scatter # ReduceScatter算子实现
| ├── reduce_scatter_v # ReduceScatterV算子实现
| ├── scatter # Scatter算子实现
| └── send # Send算子实现
├── include # HCCL对外头文件
├── test # 测试代码目录
| ├── ut # 单元测试代码目录
| └── st # 系统测试代码目录
├── docs # 资料文档目录
├── examples # 样例代码目录
└── build.sh # 编译构建脚本
📝版本配套
本项目源码会跟随CANN软件版本发布，关于CANN软件版本与本项目标签的对应关系请参阅release仓库中的相应版本说明。 请注意，为确保您的源码定制开发顺利进行，请选择配套的CANN版本与GitCode标签源码，使用master分支可能存在版本不匹配的风险。
⚡️ 快速开始
若您希望快速构建并体验本项目，请访问如下简易指南。
📖 学习教程
HCCL提供了使用指南、通信算子开发指南、技术文章、培训视频，详细可参见 HCCL 参考资料。