文件	最后提交记录	最后更新时间
01_basic_overview	fix: 修复01.02课程中轴(Axis)演示代码与文档定义不一致问题 Co-authored-by: chenmingyu<3391887644@qq.com> # message auto-generated for no-merge-commit merge: !670 merge master-fix-axis into master fix: 修复01.02课程中轴(Axis)演示代码与文档定义不一致问题 Created-by: chenmingyu Commit-by: chenmingyu Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue https://gitcode.com/cann/cann-learning-hub/issues/91 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 内容优化 - [ ] 其他，请描述： ## 其他信息 <!-- 在这里可以添加任何与这个 Pull Request 相关的其他说明。 --> See merge request: cann/cann-learning-hub!670	1 天前
02_AscendC_basic	update: 更新文件 02.04_introduction_to_kernel_functions_based_on_add_operator.ipynb Co-authored-by: chenmingyu<3391887644@qq.com> # message auto-generated for no-merge-commit merge: !555 merge master-fix-402 into master update: 更新文件 02.04_introduction_to_kernel_functions_based_on_add_operator.ipynb Created-by: chenmingyu Commit-by: chenmingyu Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 内容优化 - [ ] 其他，请描述： ## 其他信息 <!-- 在这里可以添加任何与这个 Pull Request 相关的其他说明。 --> See merge request: cann/cann-learning-hub!555	8 天前
03_intermediate_vector_operator_development	fix: 修复第3章和第5章kernel中coreNum变量命名与host侧混淆问题 Co-authored-by: chenmingyu<3391887644@qq.com> # message auto-generated for no-merge-commit merge: !695 merge master-fix-corenum into master fix: 修复第3章和第5章kernel中coreNum变量命名与host侧混淆问题 Created-by: chenmingyu Commit-by: chenmingyu Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue https://gitcode.com/cann/cann-learning-hub/issues/220 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [x] 内容优化 - [ ] 其他，请描述： ## 其他信息 <!-- 在这里可以添加任何与这个 Pull Request 相关的其他说明。 --> See merge request: cann/cann-learning-hub!695	7 小时前
04_matmul_basic	update: 更新文件 04.03_matrix_multiplication_operator_development_with_high_level_api.ipynb Co-authored-by: chenmingyu<3391887644@qq.com> # message auto-generated for no-merge-commit merge: !552 merge master-fix426 into master update: 更新文件 04.03_matrix_multiplication_operator_development_with_high_level_api.ipynb Created-by: chenmingyu Commit-by: chenmingyu Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 内容优化 - [ ] 其他，请描述： ## 其他信息 <!-- 在这里可以添加任何与这个 Pull Request 相关的其他说明。 --> See merge request: cann/cann-learning-hub!552	8 天前
05_fused_operator_development	fix: 修复第3章和第5章kernel中coreNum变量命名与host侧混淆问题 Co-authored-by: chenmingyu<3391887644@qq.com> # message auto-generated for no-merge-commit merge: !695 merge master-fix-corenum into master fix: 修复第3章和第5章kernel中coreNum变量命名与host侧混淆问题 Created-by: chenmingyu Commit-by: chenmingyu Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue https://gitcode.com/cann/cann-learning-hub/issues/220 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [x] 内容优化 - [ ] 其他，请描述： ## 其他信息 <!-- 在这里可以添加任何与这个 Pull Request 相关的其他说明。 --> See merge request: cann/cann-learning-hub!695	7 小时前
06_opensource_repo_operator_intro_and_contribution	fix: 修复06.04/06.05 UT中system()返回值未检查及compare_data.py假通过问题 Co-authored-by: chenmingyu<3391887644@qq.com> # message auto-generated for no-merge-commit merge: !646 merge master-fix-289 into master fix: 修复06.04/06.05 UT中system()返回值未检查及compare_data.py假通过问题 Created-by: chenmingyu Commit-by: chenmingyu Merged-by: cann-robot Description: ## 描述修复Issue #289中指出的06.04/06.05课后练习UT代码存在假通过的问题。 C++测试侧（test_add_custom.cpp / test_sigmoid.cpp）通过system()调用gen_data.py和compare_data.py，但完全未检查子进程返回值，且测试函数内没有任何GTest断言。导致即使精度比较失败，GTest仍无条件标记为PASSED。 Python侧（compare_data.py）存在多种假通过路径：golden或output文件列表为空时直接返回True；文件数量不一致时zip()按较短列表截断，多出的文件被静默忽略；无显式shape校验，当数组长度不匹配时np.isclose可能广播或崩溃，但崩溃的返回码同样被C++侧丢弃 ## 关联的Issue https://gitcode.com/cann/cann-learning-hub/issues/289 ## 测试对add_custom和sigmoid两组用例分别构造了多个测试场景，对比修复前后行为差异。正常数据场景：golden与output完全一致时，修复前后行为相同，均正确报告PASSED，不影响正常流程。异常数据场景：篡改output中单个元素使其与golden不匹配时，Python脚本正确检测到差异并返回非零退出码，但原版C++侧system()不检查返回值导致GTest仍报PASSED，修复后ASSERT断言捕获非零退出码，GTest正确报FAILED。 golden文件缺失场景：删除golden.bin后，原版Python脚本因文件列表为空不进入比较循环，直接返回True并退出码0，GTest报PASSED；修复版新增空列表校验，返回False并退出码1，GTest报FAILED。 output文件缺失场景：与golden缺失对称，原版同样因空列表跳过比较返回True，修复版正确拦截。文件数量不一致场景：保留1个golden文件和2个output文件时，原版zip()按较短列表截断，多出的output文件被静默忽略，返回True；修复版新增文件数量校验，检测到不匹配后返回False。 shape不一致场景：将output截断为1024个元素（golden为2048）时，原版np.isclose因形状不兼容抛出ValueError崩溃，虽然崩溃返回非零码但C++侧不检查仍报PASSED；修复版在调用isclose之前先做shape校验，优雅地返回False并打印明确的错误信息，不会崩溃。 sigmoid用例同步验证了正常数据、golden缺失、数据错误三个场景，行为与add_custom一致。总体结论：原版在8个异常场景中全部假通过，修复版在所有场景中均正确判定，正常数据不受影响。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [x] 内容优化 - [ ] 其他，请描述： ## 其他信息 <!-- 在这里可以添加任何与这个 Pull Request 相关的其他说明。 --> See merge request: cann/cann-learning-hub!646	1 天前
07_Troubleshooting	fix: update TQue queue depth from feat/update-tque-queue-depth branch Co-authored-by: ink-polymer<2020611156@qq.com> Co-authored-by: gitcode-bot<noreply@gitcode.com> # message auto-generated for no-merge-commit merge: !362 merge fix/update-tque-queue-depth into master fix: update TQue queue depth from feat/update-tque-queue-depth branch Created-by: ink_polymer Commit-by: ink_polymer;ink-polymer;gitcode-bot Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。-->修改宏相关设定以及图片修改 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。-->https://gitcode.com/cann/cann-learning-hub/issues/171 https://gitcode.com/cann/cann-learning-hub/issues/87 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> quick_start/cann_basics/03_what_is_cann.ipynb tutorials/ascendc_operator_development/02_AscendC_basic/02.04_introduction_to_kernel_functions_based_on_add_operator.ipynb tutorials/ascendc_operator_development/02_AscendC_basic/src/add_custom.asc tutorials/ascendc_operator_development/02_AscendC_basic/02.05_chapter_test.ipynb tutorials/ascendc_operator_development/03_intermediate_vector_operator_development/03.02_operator_engineering_intro.ipynb tutorials/ascendc_operator_development/03_intermediate_vector_operator_development/03.04_generalized_tiling_design.ipynb tutorials/ascendc_operator_development/03_intermediate_vector_operator_development/03.05_tiling_template_attr_tbuf_workspace.ipynb tutorials/ascendc_operator_development/03_intermediate_vector_operator_development/src/custom_op/op_kernel/add_custom_template.cpp tutorials/ascendc_operator_development/03_intermediate_vector_operator_development/src/custom_op_04/op_kernel/add_custom_template.cpp tutorials/ascendc_operator_development/03_intermediate_vector_operator_development/answer/03.02_answer/op_kernel/sub_custom_template.cpp tutorials/ascendc_operator_development/03_intermediate_vector_operator_development/answer/03.04_answer/op_kernel/sub_custom_template.cpp tutorials/ascendc_operator_development/03_intermediate_vector_operator_development/answer/03.05_answer/op_kernel/add_custom_template.cpp tutorials/ascendc_operator_development/03_intermediate_vector_operator_development/answer/03.06_answer/op_kernel/sigmoid_custom.cpp tutorials/ascendc_operator_development/05_fused_operator_development/05.03_vv_fused_operator_development.ipynb tutorials/ascendc_operator_development/05_fused_operator_development/answer/05.03_answer/op_kernel/square_diff.cpp tutorials/ascendc_operator_development/06_opensource_repo_operator_intro_and_contribution/06.03_operator_development_based_on_opensource_repo.ipynb tutorials/ascendc_operator_development/06_opensource_repo_operator_intro_and_contribution/06.05_chapter_practice.ipynb tutorials/ascendc_operator_development/06_opensource_repo_operator_intro_and_contribution/answer/06.03_answer/op_kernel/sub_custom.h tutorials/ascendc_operator_development/06_opensource_repo_operator_intro_and_contribution/answer/06.05_answer/op_kernel/sigmoid.h tutorials/ascendc_operator_development/06_opensource_repo_operator_intro_and_contribution/src/add_custom/op_kernel/add_custom.h tutorials/ascendc_operator_development/07_Troubleshooting/07.02_CPU_Debugging_Overview.ipynb tutorials/ascendc_operator_development/07_Troubleshooting/07.03_NPU_On-Board_Debugging.ipynb tutorials/ascendc_operator_development/07_Troubleshooting/07.04_Typical_Issues_in_AscendC_Operator_Development.ipynb tutorials/ascendc_operator_development/07_Troubleshooting/07.05_chapter_test.ipynb tutorials/ascendc_operator_development/08_performance_optimization/08.02_profiling_tool_usage.ipynb tutorials/ascendc_operator_development/08_performance_optimization/08.03_simulation_analysis.ipynb tutorials/ascendc_operator_development/08_performance_optimization/08.04_ascendc_op_perf_optimization_demo.ipynb tutorials/ascendc_operator_development/08_performance_optimization/08.05_chapter_practice.ipynb tutorials/ascendc_operator_development/08_performance_optimization/src/custom_op/op_kernel/add_custom_template.cpp tutorials/ascendc_operator ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 内容优化 - [ ] 其他，请描述： ## 其他信息 <!-- 在这里可以添加任何与这个 Pull Request 相关的其他说明。 --> See merge request: cann/cann-learning-hub!362	25 天前
08_performance_optimization	fix - sigmoid.h 用 x/x 造常数1，x=0时NaN Co-authored-by: chenmingyu<3391887644@qq.com> # message auto-generated for no-merge-commit merge: !571 merge master-fix-472 into master fix - sigmoid.h 用 x/x 造常数1，x=0时NaN Created-by: chenmingyu Commit-by: chenmingyu Merged-by: cann-robot Description: ## 描述修复 08.04 性能优化教程中 4.2.1 Host侧修改的公式错误：正文公式遗漏了除以 blockDim（40），导致计算值比实际大 40 倍。改为：单核单次搬运量 = 45 × 20480 × sizeof(half) / (blockDim × tileNum) = 46080 / tileNum 字节，并补充求解过程 tileNum ≤ 2。 ## 关联的Issue https://gitcode.com/cann/cann-learning-hub/issues/470 https://gitcode.com/cann/cann-learning-hub/issues/472 ## 测试公式修正：手工验算 45×20480×2/(40×tileNum)，tileNum=360 时结果128B，与4.1节数据一致 sigmoid 修复：Python 模拟四组对比测试（课程数据/含0数据/大批量/改进gen_data），课程数据下原代码与修复后输出完全一致（max_diff=0），含0时原代码产生NaN修复后正常输出0.5 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ x] Bug修复 - [ ] 新特性 - [ x] 内容优化 - [ ] 其他，请描述： ## 其他信息 <!-- 在这里可以添加任何与这个 Pull Request 相关的其他说明。 --> See merge request: cann/cann-learning-hub!571	7 天前
09_course_practice	change to cann9.0 Co-authored-by: waimaidaole<1595992831@qq.com> # message auto-generated for no-merge-commit merge: !255 merge master into master change to cann9.0 Created-by: waimaidaole Commit-by: waimaidaole Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 内容优化 - [ ] 其他，请描述： ## 其他信息 <!-- 在这里可以添加任何与这个 Pull Request 相关的其他说明。 --> See merge request: cann/cann-learning-hub!255	1 个月前
README.md	update: 更新文件 README.md Co-authored-by: Saturday22266<xyi3719@gmail.com> # message auto-generated for no-merge-commit merge: !697 merge fix/asc_operator_develop_master into master update: 更新文件 README.md Created-by: Saturday22266 Commit-by: Saturday22266 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> cann-learning-hub/tutorials/ascendc_operator_development/README.md 中增添了一些信息 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新了README.md文件 See merge request: cann/cann-learning-hub!697	7 小时前

Ascend C 算子开发系列教程

本教程将带你学习面向昇腾 NPU 的 Ascend C 高性能算子开发全流程，涵盖从算子基础概念、核函数开发、工程化 Tiling 模板化编程，到矩阵乘高阶 API、融合算子、算子调试与性能优化等核心内容，帮助开发者系统掌握 Ascend C 算子开发技能。

教程按章节划分，每个章节均包含以下内容：

Notebooks：包含课程知识点与练习题，适用于自主学习或讲师引导式教学，可在 gitcode 提供的轻量级 notebook 上运行。也可自行搭建 jupyter lab，在本地环境执行使用。
SRC：包含课程中所有的源码，供开发者自行下载及修改。
PPT（建设中）：包含各课时的授课内容。

适用人群

希望了解并掌握 Ascend C 算子编程方法的开发者
AI 算法工程师、C/C++ 开发者、算子开发工程师

前置知识要求

在学习本教程之前，建议先完成以下前置学习：

阅读 cann-learning-hub 快速入门中的 cann_basics 章节，了解 AI 基础概念、NPU 硬件架构与 CANN 软件栈
掌握 C/C++ 编程基础
了解并行编程基本概念

整体学习目标

掌握 Ascend C 核函数开发与调用方式，理解编程范式与 API 体系
掌握工程化算子开发方法，包括 Tiling 模板化编程、Tbuf、Workspace 等机制
掌握基于高阶 API 的矩阵乘算子开发（MIX / Cube 模式）
掌握 VV 融合与 CV 融合等典型融合算子开发
掌握 Ascend C 算子功能调试方法与性能优化工具链（msProf）

软硬件配套说明

项目	要求
支持硬件	Atlas A2 训练/推理系列产品、Atlas A3 训练/推理系列产品
CANN 版本	9.0.0 及以上
Python	3.11

在线体验环境

本教程支持以下在线体验环境：

体验环境	镜像模板 / 版本	Python 内核	说明
cann-learning-hub 在线体验 notebook	cann_9.0.0_py3.11-A2-arm	Python 3.11.15	各 Notebook 表格中的"在线体验"链接可直接打开运行
CANNLab 云开发环境	cann_9.0.0_py3.11-A2-arm	Python 3.11.4	参考 CANNLab 环境体验指南创建CANNLab环境运行notebook

注意： 如在本地环境离线体验，需自行安装配套的 CANN 软件，具体请参考 CANN 安装指南，并选择对应CANN版本的文档。

Ascend C算子开发系列（初级）

第一章：面向昇腾NPU的高性能算子开发语言

Notebook	Link	状态
1.1 章节介绍	在线体验	✅ 已发布
1.2 人工智能与算子基础	在线体验	✅ 已发布
1.3 CANN架构与昇腾NPU原理	在线体验	✅ 已发布
1.4 Ascend C算子开发的基本概念	在线体验	✅ 已发布
1.5 章节练习	在线体验	✅ 已发布

第二章：Ascend C算子开发基础知识

Notebook	Link	状态
2.1 章节介绍	在线体验	✅ 已发布
2.2 Ascend C的"Hello world"	在线体验	✅ 已发布
2.3 AscendC编程范式介绍与API介绍	在线体验	✅ 已发布
2.4 基于Add算子的核函数介绍	在线体验	✅ 已发布
2.5 章节实践	在线体验	✅ 已发布

Ascend C算子开发系列（中级）

第三章：Vector算子开发

Notebook	Link	状态
3.1 章节介绍	在线体验	✅ 已发布
3.2 工程化算子开发介绍	在线体验	✅ 已发布
3.3 aclnn和pybind调用	在线体验	✅ 已发布
3.4 泛化Tiling设计	在线体验	✅ 已发布
3.5 tiling模板化编程、属性、Tbuf、workspace的使用	在线体验	✅ 已发布
3.6 章节实践	在线体验	✅ 已发布

第四章：矩阵算子开发

Notebook	Link	状态
4.1 章节介绍	在线体验	✅ 已发布
4.2 矩阵乘法介绍	在线体验	✅ 已发布
4.3 基于高阶API的矩阵乘算子开发	在线体验	✅ 已发布
4.4 章节实践	在线体验	✅ 已发布

第五章：融合算子开发

Notebook	Link	状态
5.1 章节介绍	在线体验	✅ 已发布
5.2 融合算子概念介绍	在线体验	✅ 已发布
5.3 VV融合算子开发	在线体验	✅ 已发布
5.4 CV融合算子开发	在线体验	✅ 已发布
5.5 章节实践	在线体验	✅ 已发布

第六章：CANN开源算子仓--昇腾NPU异构计算全场景算子开发、验证与贡献一站式平台

Notebook	Link	状态
6.1 章节介绍	在线体验	✅ 已发布
6.2 开源仓介绍及验证	在线体验	✅ 已发布
6.3 基于开源仓的算子开发	在线体验	✅ 已发布
6.4 UT的编写及验证	在线体验	✅ 已发布
6.5 章节实践	在线体验	✅ 已发布

Ascend C算子开发系列（高级）

第七章：Ascend C算子功能调试

Notebook	Link	状态
7.1 章节介绍	在线体验	✅ 已发布
7.2 CPU域孪生调试	在线体验	✅ 已发布
7.3 NPU域上板调试	在线体验	✅ 已发布
7.4 Ascend C算子开发典型问题	在线体验	✅ 已发布
7.5 章节实践	在线体验	✅ 已发布

第八章：Ascend C算子性能优化

Notebook	Link	状态
8.1 章节介绍	在线体验	✅ 已发布
8.2 msProf工具使用技巧	在线体验	✅ 已发布
8.3 仿真分析	在线体验	✅ 已发布
8.4 Ascend C算子性能优化典型示例	在线体验	✅ 已发布
8.5 章节实践	在线体验	✅ 已发布

第九章：Ascend C算子开发实践

Notebook	Link	状态
9.1 vector算子开发实践	在线体验	✅ 已发布