| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
【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 | 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 | 1 个月前 | |
【PR】: 新增 Event 等待状态与超时诊断样例 Co-authored-by: 2403_89963296<2540257541@qq.com> # message auto-generated for no-merge-commit merge: !4929 merge example/1_basic_features/event/2_event_wait_diagnostics into master 【PR】: 新增 Event 等待状态与超时诊断样例 Created-by: 2403_89963296 Commit-by: 2403_89963296 Merged-by: cann-robot Description: # Pull Request ## 描述 新增 example/1_basic_features/event/2_event_wait_diagnostics 样例，演示单 Device 应用中生产者 Stream 与消费者 Stream 通过普通 Event 建立任务依赖并诊断等待过程。 主要变更如下： 1. 查询普通 Event 创建前后的可用数量，并在首次 Record 后获取 Event ID。 2. 生产者 Stream 执行 value += 1 的耗时任务并 Record Event；消费者 Stream 使用 5 秒有限超时等待该 Event。 3. 分别在消费者同步前后查询等待状态，验证其从 NOT_READY 迁移为 COMPLETE。 4. 消费者执行依赖任务 value *= 2，校验最终结果为 2，形成任务依赖验证闭环。 5. 补充 CMake 构建配置、自动化运行脚本、中英文 README，并更新 Event 样例中英文导航。 6. 正常路径按顺序释放资源，异常路径使用强制 Stream/Device 清理接口回收已创建资源。 ## 变更类型 - [ ] 🐛 Bug 修复 - [x] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 如何测试 测试环境： - CANN：9.2.0-weekly.20260909.01 - SoC：Ascend910_9362 - 编译器：GCC/G++ 13.3.0 测试步骤： 1. 进入 example/1_basic_features/event/2_event_wait_diagnostics 目录。 2. 执行 bash run.sh，完成环境解析、CMake 配置、编译和运行。 3. 检查脚本退出码和输出日志。 测试结果： - CMake 配置及编译成功，样例进程正常退出。 - Event 创建前后的可用数量均为 65536，符合普通 Event 可能在首次 Record 时申请底层资源的预期。 - 首次 Record 后成功获取 Event ID 0。 - 消费者同步前等待状态为 NOT_READY，同步后为 COMPLETE。 - 最终输出为 2，与预期一致。 - 脚本输出 [SUCCESS] Event wait diagnostics sample executed successfully.。 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：feat:, fix:） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息 - 普通 Event 的底层资源可能在首次 Record 时才实际申请，因此样例只展示创建前后的 Event 可用数量，不断言其必须减少一个。 - Event 必须通过 aclrtCreateEvent 创建，不能替换为 aclrtCreateEventExWithFlag，以保证样例覆盖普通 Event 的行为。 See merge request: cann/runtime!4929 | 25 天前 | |
【PR】: 新增算子与跨流 Event 分层超时控制样例 Co-authored-by: 2403_89963296<2540257541@qq.com> # message auto-generated for no-merge-commit merge: !5025 merge example/1_basic_features/event/3_bounded_cross_stream_execution into master 【PR】: 新增算子与跨流 Event 分层超时控制样例 Created-by: 2403_89963296 Commit-by: 2403_89963296 Merged-by: cann-robot Description: # Pull Request ## 描述 新增 3_bounded_cross_stream_execution 单 Device 样例，演示应用如何组合算子执行超时、跨 Stream Event 等待超时和 Device 同步超时，并通过实际数据结果验证任务依赖。 - 覆盖 aclrtGetOpTimeOutInterval、aclrtSetOpExecuteTimeOut、aclrtSetOpExecuteTimeOutV2、aclrtGetOpExecuteTimeout、aclrtSetOpWaitTimeout 和 aclrtSynchronizeDeviceWithTimeout。 - 读取硬件算子超时时间粒度，设置秒级超时并回读硬件实际值。 - 设置非粒度整数倍的微秒超时，验证硬件向上对齐后的实际生效值。 - 为消费者 Stream 的 Event Wait 任务设置 5 秒等待预算。 - 提交生产者 Host 到 Device 异步复制和消费者 Device 到 Host 异步复制，在 5000 毫秒内完成 Device 同步。 - 逐项比较 256 个输入输出值，验证跨 Stream Event 依赖正确执行。 - 补充中英文样例文档、构建运行脚本以及 Event 主题中英文导航。 ## 变更类型 - [ ] 🐛 Bug 修复 - [x] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 如何测试 1. 在环境加载 CANN 和样例编译环境： bash source ${install_root}/cann/set_env.sh source ${git_clone_path}/example/set_sample_env.sh 2. 构建并运行样例： bash cd ${git_clone_path}/example/1_basic_features/event/3_bounded_cross_stream_execution bash run.sh 3. 检查运行结果： text [INFO] Hardware operation timeout interval: 4294967 us. [INFO] Second-level request: 1 s; hardware readback: 4295 ms. [INFO] Microsecond request: 4294968 us; actual: 8589934 us. [INFO] Event wait budget: 5 s. [INFO] Device synchronized within 5000 ms. [INFO] Verified 256 values transferred across the Event dependency. [INFO] [SUCCESS] Bounded cross-Stream execution sample completed successfully. [SUCCESS] Bounded cross-Stream execution sample executed successfully. 验证环境： - CANN：9.2.0-weekly.20260909.01 - Device：Ascend910_9362（Atlas A2） - pre-commit：clang-format、OAT 均通过 - 脚本语法、差异空白检查、CMake 构建和 Device 运行均通过 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：feat:, fix:） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息 - 关键 API 的产品支持范围交集为 Atlas A2、Atlas A3 和 Ascend 950PR/Ascend 950DT。 - 6 个目标 API 均已纳入样例，没有未覆盖接口。 - 本次仅新增编号样例并更新直属 Event 主题导航，不修改已有可运行样例或共享辅助代码。 See merge request: cann/runtime!5025 | 22 天前 | |
【PR】: 新增算子与跨流 Event 分层超时控制样例 Co-authored-by: 2403_89963296<2540257541@qq.com> # message auto-generated for no-merge-commit merge: !5025 merge example/1_basic_features/event/3_bounded_cross_stream_execution into master 【PR】: 新增算子与跨流 Event 分层超时控制样例 Created-by: 2403_89963296 Commit-by: 2403_89963296 Merged-by: cann-robot Description: # Pull Request ## 描述 新增 3_bounded_cross_stream_execution 单 Device 样例，演示应用如何组合算子执行超时、跨 Stream Event 等待超时和 Device 同步超时，并通过实际数据结果验证任务依赖。 - 覆盖 aclrtGetOpTimeOutInterval、aclrtSetOpExecuteTimeOut、aclrtSetOpExecuteTimeOutV2、aclrtGetOpExecuteTimeout、aclrtSetOpWaitTimeout 和 aclrtSynchronizeDeviceWithTimeout。 - 读取硬件算子超时时间粒度，设置秒级超时并回读硬件实际值。 - 设置非粒度整数倍的微秒超时，验证硬件向上对齐后的实际生效值。 - 为消费者 Stream 的 Event Wait 任务设置 5 秒等待预算。 - 提交生产者 Host 到 Device 异步复制和消费者 Device 到 Host 异步复制，在 5000 毫秒内完成 Device 同步。 - 逐项比较 256 个输入输出值，验证跨 Stream Event 依赖正确执行。 - 补充中英文样例文档、构建运行脚本以及 Event 主题中英文导航。 ## 变更类型 - [ ] 🐛 Bug 修复 - [x] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 如何测试 1. 在环境加载 CANN 和样例编译环境： bash source ${install_root}/cann/set_env.sh source ${git_clone_path}/example/set_sample_env.sh 2. 构建并运行样例： bash cd ${git_clone_path}/example/1_basic_features/event/3_bounded_cross_stream_execution bash run.sh 3. 检查运行结果： text [INFO] Hardware operation timeout interval: 4294967 us. [INFO] Second-level request: 1 s; hardware readback: 4295 ms. [INFO] Microsecond request: 4294968 us; actual: 8589934 us. [INFO] Event wait budget: 5 s. [INFO] Device synchronized within 5000 ms. [INFO] Verified 256 values transferred across the Event dependency. [INFO] [SUCCESS] Bounded cross-Stream execution sample completed successfully. [SUCCESS] Bounded cross-Stream execution sample executed successfully. 验证环境： - CANN：9.2.0-weekly.20260909.01 - Device：Ascend910_9362（Atlas A2） - pre-commit：clang-format、OAT 均通过 - 脚本语法、差异空白检查、CMake 构建和 Device 运行均通过 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：feat:, fix:） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息 - 关键 API 的产品支持范围交集为 Atlas A2、Atlas A3 和 Ascend 950PR/Ascend 950DT。 - 6 个目标 API 均已纳入样例，没有未覆盖接口。 - 本次仅新增编号样例并更新直属 Event 主题导航，不修改已有可运行样例或共享辅助代码。 See merge request: cann/runtime!5025 | 22 天前 | |
【PR】: 新增算子与跨流 Event 分层超时控制样例 Co-authored-by: 2403_89963296<2540257541@qq.com> # message auto-generated for no-merge-commit merge: !5025 merge example/1_basic_features/event/3_bounded_cross_stream_execution into master 【PR】: 新增算子与跨流 Event 分层超时控制样例 Created-by: 2403_89963296 Commit-by: 2403_89963296 Merged-by: cann-robot Description: # Pull Request ## 描述 新增 3_bounded_cross_stream_execution 单 Device 样例，演示应用如何组合算子执行超时、跨 Stream Event 等待超时和 Device 同步超时，并通过实际数据结果验证任务依赖。 - 覆盖 aclrtGetOpTimeOutInterval、aclrtSetOpExecuteTimeOut、aclrtSetOpExecuteTimeOutV2、aclrtGetOpExecuteTimeout、aclrtSetOpWaitTimeout 和 aclrtSynchronizeDeviceWithTimeout。 - 读取硬件算子超时时间粒度，设置秒级超时并回读硬件实际值。 - 设置非粒度整数倍的微秒超时，验证硬件向上对齐后的实际生效值。 - 为消费者 Stream 的 Event Wait 任务设置 5 秒等待预算。 - 提交生产者 Host 到 Device 异步复制和消费者 Device 到 Host 异步复制，在 5000 毫秒内完成 Device 同步。 - 逐项比较 256 个输入输出值，验证跨 Stream Event 依赖正确执行。 - 补充中英文样例文档、构建运行脚本以及 Event 主题中英文导航。 ## 变更类型 - [ ] 🐛 Bug 修复 - [x] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 如何测试 1. 在环境加载 CANN 和样例编译环境： bash source ${install_root}/cann/set_env.sh source ${git_clone_path}/example/set_sample_env.sh 2. 构建并运行样例： bash cd ${git_clone_path}/example/1_basic_features/event/3_bounded_cross_stream_execution bash run.sh 3. 检查运行结果： text [INFO] Hardware operation timeout interval: 4294967 us. [INFO] Second-level request: 1 s; hardware readback: 4295 ms. [INFO] Microsecond request: 4294968 us; actual: 8589934 us. [INFO] Event wait budget: 5 s. [INFO] Device synchronized within 5000 ms. [INFO] Verified 256 values transferred across the Event dependency. [INFO] [SUCCESS] Bounded cross-Stream execution sample completed successfully. [SUCCESS] Bounded cross-Stream execution sample executed successfully. 验证环境： - CANN：9.2.0-weekly.20260909.01 - Device：Ascend910_9362（Atlas A2） - pre-commit：clang-format、OAT 均通过 - 脚本语法、差异空白检查、CMake 构建和 Device 运行均通过 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：feat:, fix:） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息 - 关键 API 的产品支持范围交集为 Atlas A2、Atlas A3 和 Ascend 950PR/Ascend 950DT。 - 6 个目标 API 均已纳入样例，没有未覆盖接口。 - 本次仅新增编号样例并更新直属 Event 主题导航，不修改已有可运行样例或共享辅助代码。 See merge request: cann/runtime!5025 | 22 天前 |
event
本目录聚焦 Event 的状态查询、时间戳记录与同步能力。
样例列表
- 0_event_status：演示 Event 状态查询与同步流程。
- 1_event_timestamp：演示 Event 时间戳采集与计时用法。
- 2_event_wait_diagnostics：演示多 Stream Event 等待状态与超时诊断流程。
- 3_bounded_cross_stream_execution：演示算子、Event 等待与 Device 同步的分层超时控制，并校验跨 Stream 数据结果。