| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
【PR】[fix] correct examples' log messages Co-authored-by: Hou_jialin<houjialin3@huawei.com> # message auto-generated for no-merge-commit merge: !4653 merge br_example_log_fix into master 【PR】[fix] correct examples' log messages Created-by: Hou_jialin Commit-by: Hou_jialin Merged-by: cann-robot Description: # Pull Request ## 描述 优化 Runtime Example 日志的规范性和易读性： - 将运行状态和错误信息统一使用 INFO_LOG、WARN_LOG、ERROR_LOG 输出，保留结果数据的直接打印。 - 修正日志中的拼写、语法、单位和错误上下文描述。 - 将不支持 UVM 的跳过提示调整为 WARN 级别。 - 同步更新中英文 README 中的示例输出。 - 将 custom_kernel_launch 的公共头文件路径限制在 main target，避免影响自定义 Kernel target。 本次修改不改变样例的计算逻辑、Runtime API 调用流程和接口行为。 ## 变更类型 - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试 1. 执行受影响示例的 run.sh，并检查构建结果、退出码和示例输出。 测试结果： - 涉及修改的示例完成构建并实际运行成功。 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：feat:, fix:） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息 本次 PR 仅整改 Example 日志和对应文档，不涉及 Runtime ABI 及产品功能变更。 See merge request: cann/runtime!4653 | 26 天前 | |
【PR】: feat:remove all exclude Co-authored-by: duanpengliang<duanpengliang@huawei.com> # message auto-generated for no-merge-commit merge: !4195 merge master_precommit into master 【PR】: feat:remove all exclude Created-by: duanpengliang Commit-by: duanpengliang Merged-by: cann-robot Description: # Pull Request ## 描述 pre-commit example scripts docs，并把这些目录pre-commit排除项给去掉 ## 变更类型 请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [x] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [ ] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试 pre-commit readme docs无新增文件 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如： feat:, fix:） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息 在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!4195 | 1 个月前 | |
【PR】: feat:remove all exclude Co-authored-by: duanpengliang<duanpengliang@huawei.com> # message auto-generated for no-merge-commit merge: !4195 merge master_precommit into master 【PR】: feat:remove all exclude Created-by: duanpengliang Commit-by: duanpengliang Merged-by: cann-robot Description: # Pull Request ## 描述 pre-commit example scripts docs，并把这些目录pre-commit排除项给去掉 ## 变更类型 请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [x] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [ ] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试 pre-commit readme docs无新增文件 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如： feat:, fix:） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息 在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!4195 | 1 个月前 | |
【PR】: feat:remove all exclude Co-authored-by: duanpengliang<duanpengliang@huawei.com> # message auto-generated for no-merge-commit merge: !4195 merge master_precommit into master 【PR】: feat:remove all exclude Created-by: duanpengliang Commit-by: duanpengliang Merged-by: cann-robot Description: # Pull Request ## 描述 pre-commit example scripts docs，并把这些目录pre-commit排除项给去掉 ## 变更类型 请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [x] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [ ] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试 pre-commit readme docs无新增文件 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如： feat:, fix:） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息 在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!4195 | 1 个月前 | |
【PR】[fix] correct examples' log messages Co-authored-by: Hou_jialin<houjialin3@huawei.com> # message auto-generated for no-merge-commit merge: !4653 merge br_example_log_fix into master 【PR】[fix] correct examples' log messages Created-by: Hou_jialin Commit-by: Hou_jialin Merged-by: cann-robot Description: # Pull Request ## 描述 优化 Runtime Example 日志的规范性和易读性： - 将运行状态和错误信息统一使用 INFO_LOG、WARN_LOG、ERROR_LOG 输出，保留结果数据的直接打印。 - 修正日志中的拼写、语法、单位和错误上下文描述。 - 将不支持 UVM 的跳过提示调整为 WARN 级别。 - 同步更新中英文 README 中的示例输出。 - 将 custom_kernel_launch 的公共头文件路径限制在 main target，避免影响自定义 Kernel target。 本次修改不改变样例的计算逻辑、Runtime API 调用流程和接口行为。 ## 变更类型 - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试 1. 执行受影响示例的 run.sh，并检查构建结果、退出码和示例输出。 测试结果： - 涉及修改的示例完成构建并实际运行成功。 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：feat:, fix:） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息 本次 PR 仅整改 Example 日志和对应文档，不涉及 Runtime ABI 及产品功能变更。 See merge request: cann/runtime!4653 | 26 天前 | |
【PR】:新增 ACL 引用计数插件生命周期样例 Co-authored-by: 2403_89963296<2540257541@qq.com> # message auto-generated for no-merge-commit merge: !4840 merge 新增用例-0_quickstart/5_runtime_lifecycle_callbacks/0_reference_counted_plugin_lifecycle into master 【PR】:新增 ACL 引用计数插件生命周期样例 Created-by: 2403_89963296 Commit-by: 2403_89963296 Merged-by: cann-robot Description: # Pull Request ## 描述 在 example/0_quickstart/5_runtime_lifecycle_callbacks/ 下新增 0_reference_counted_plugin_lifecycle 样例。 样例展示 ACL 初始化与去初始化回调的注册、注销和触发过程，并通过 aclFinalizeReference 验证引用计数归零后的去初始化行为。同时完成 Device 0 设置与查询、异常路径清理以及最终业务不变量校验。 ## 变更类型 - [ ] 🐛 Bug 修复 - [x] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 如何测试 测试环境：Atlas A3 单 Device 环境。 1. 执行 source ${install_root}/set_env.sh。 2. 执行 source ${git_clone_path}/example/set_sample_env.sh。 3. 进入样例目录并执行 bash run.sh。 4. 确认有效初始化和去初始化回调各执行一次，已注销回调均未执行。 5. 确认 Device 0 设置成功、最终引用计数为 0，并输出样例成功标记。 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：feat:, fix:） - [x] 我已经详细阅读并遵守贡献指南 ## 其他信息 样例涉及的生命周期接口静态支持 Atlas A2、Atlas A3 和 Ascend 950 系列产品，当前样例 README 记录已在 Atlas A3, A5 单 Device 环境完成实机验证。 See merge request: cann/runtime!4840 | 17 天前 | |
【PR】:新增 ACL 引用计数插件生命周期样例 Co-authored-by: 2403_89963296<2540257541@qq.com> # message auto-generated for no-merge-commit merge: !4840 merge 新增用例-0_quickstart/5_runtime_lifecycle_callbacks/0_reference_counted_plugin_lifecycle into master 【PR】:新增 ACL 引用计数插件生命周期样例 Created-by: 2403_89963296 Commit-by: 2403_89963296 Merged-by: cann-robot Description: # Pull Request ## 描述 在 example/0_quickstart/5_runtime_lifecycle_callbacks/ 下新增 0_reference_counted_plugin_lifecycle 样例。 样例展示 ACL 初始化与去初始化回调的注册、注销和触发过程，并通过 aclFinalizeReference 验证引用计数归零后的去初始化行为。同时完成 Device 0 设置与查询、异常路径清理以及最终业务不变量校验。 ## 变更类型 - [ ] 🐛 Bug 修复 - [x] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 如何测试 测试环境：Atlas A3 单 Device 环境。 1. 执行 source ${install_root}/set_env.sh。 2. 执行 source ${git_clone_path}/example/set_sample_env.sh。 3. 进入样例目录并执行 bash run.sh。 4. 确认有效初始化和去初始化回调各执行一次，已注销回调均未执行。 5. 确认 Device 0 设置成功、最终引用计数为 0，并输出样例成功标记。 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：feat:, fix:） - [x] 我已经详细阅读并遵守贡献指南 ## 其他信息 样例涉及的生命周期接口静态支持 Atlas A2、Atlas A3 和 Ascend 950 系列产品，当前样例 README 记录已在 Atlas A3, A5 单 Device 环境完成实机验证。 See merge request: cann/runtime!4840 | 17 天前 | |
【PR】:新增 ACL 引用计数插件生命周期样例 Co-authored-by: 2403_89963296<2540257541@qq.com> # message auto-generated for no-merge-commit merge: !4840 merge 新增用例-0_quickstart/5_runtime_lifecycle_callbacks/0_reference_counted_plugin_lifecycle into master 【PR】:新增 ACL 引用计数插件生命周期样例 Created-by: 2403_89963296 Commit-by: 2403_89963296 Merged-by: cann-robot Description: # Pull Request ## 描述 在 example/0_quickstart/5_runtime_lifecycle_callbacks/ 下新增 0_reference_counted_plugin_lifecycle 样例。 样例展示 ACL 初始化与去初始化回调的注册、注销和触发过程，并通过 aclFinalizeReference 验证引用计数归零后的去初始化行为。同时完成 Device 0 设置与查询、异常路径清理以及最终业务不变量校验。 ## 变更类型 - [ ] 🐛 Bug 修复 - [x] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 如何测试 测试环境：Atlas A3 单 Device 环境。 1. 执行 source ${install_root}/set_env.sh。 2. 执行 source ${git_clone_path}/example/set_sample_env.sh。 3. 进入样例目录并执行 bash run.sh。 4. 确认有效初始化和去初始化回调各执行一次，已注销回调均未执行。 5. 确认 Device 0 设置成功、最终引用计数为 0，并输出样例成功标记。 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：feat:, fix:） - [x] 我已经详细阅读并遵守贡献指南 ## 其他信息 样例涉及的生命周期接口静态支持 Atlas A2、Atlas A3 和 Ascend 950 系列产品，当前样例 README 记录已在 Atlas A3, A5 单 Device 环境完成实机验证。 See merge request: cann/runtime!4840 | 17 天前 |
0_quickstart
本章节面向首次接触 Runtime 样例工程的开发者，先通过最小计算闭环跑通编译和执行流程，再补充错误处理、系统信息查询、跨版本兼容和自定义 Kernel 调用等入门主题。
样例列表
- 0_hello_cann：展示初始化配置、Device/Stream 管理、Tensor 与 DataBuffer 准备、workspace 申请、
aclnnAdd向量加法执行、同步等待和资源释放。 - 1_error_handling：展示统一返回值检查、线程级 Runtime 错误码查询、最近错误描述获取和详细错误摘要查询。
- 2_system_info：展示 Runtime API 版本、CANN 软件包版本、运行模式、float16/float32 转换和数据类型大小查询。
- 4_custom_kernel_launch：展示使用
<<<>>>内核调用符下发自定义 AscendC Kernel 的最小流程。 - 5_runtime_lifecycle_callbacks：展示应用插件参与 ACL 初始化与去初始化流程，并通过回调注册、注销和引用计数验证生命周期语义。
相关主题
- 3_cross_version：跨版本编译、接口差异适配和兼容性处理。