cann-robot【PR】: 新接口timeout参数统一使用uint32_t类型

Files	Last commit	Last update
0_quickstart	【PR】: fix issue Co-authored-by: shi-qiong<shiqiong3@huawei.com> # message auto-generated for no-merge-commit merge: !3309 merge feature/issue-fix into master 【PR】: fix issue Created-by: shi-qiong Commit-by: shi-qiong Merged-by: cann-robot Description: # Pull Request ## 描述请清晰准确地描述本次 Pull Request 的意图和变更内容。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> 621 ## 如何测试描述测试此变更的步骤和前提条件： 1. 2. ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!3309	20 days ago
1_basic_features	【PR】: fix issue Co-authored-by: shi-qiong<shiqiong3@huawei.com> # message auto-generated for no-merge-commit merge: !3309 merge feature/issue-fix into master 【PR】: fix issue Created-by: shi-qiong Commit-by: shi-qiong Merged-by: cann-robot Description: # Pull Request ## 描述请清晰准确地描述本次 Pull Request 的意图和变更内容。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> 621 ## 如何测试描述测试此变更的步骤和前提条件： 1. 2. ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!3309	20 days ago
2_advanced_features	【PR】: 新接口timeout参数统一使用uint32_t类型 Co-authored-by: SongAnyin<songanyin@huawei.com> # message auto-generated for no-merge-commit merge: !3390 merge master-7-2 into master 【PR】: 新接口timeout参数统一使用uint32_t类型 Created-by: SongAnyin Commit-by: SongAnyin Merged-by: cann-robot Description: # Pull Request ## 描述新接口timeout参数统一使用uint32_t类型。用0表示永不超时。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [x] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试描述测试此变更的步骤和前提条件： 1. 2. ## 核对清单 <!-- [x] 表示选中 --> - [ ] 我的代码遵循了项目的代码风格 - [ ] 我已对代码进行了自测 - [ ] 我已更新了相关的文档 - [ ] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [ ] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!3390	18 days ago
3_memory_advanced	【PR】: 增加UVM内存申请相关用例 Co-authored-by: hnn___36<haoyijun1@huawei.com> # message auto-generated for no-merge-commit merge: !3131 merge master into master 【PR】: 增加UVM内存申请相关用例 Created-by: hnn___36 Commit-by: hnn___36 Merged-by: cann-robot Description: # Pull Request ## 描述增加UVM用例，通过UVM内存申请接口为算子输入、输出分配内存，消除了算子参数追加和结果写回过程中的显式数据搬运。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [x] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue NA ## 如何测试描述测试此变更的步骤和前提条件： 1. 下载样例代码至安装 CANN 软件的环境，切换到样例目录。 `bash cd ${git_clone_path}/example/3_memory_advanced/managed_memory/0_uvm_allocate` 2. 设置环境变量。 `bash # ${install_root} 替换为 CANN 安装根目录，默认安装在 /usr/local/Ascend 目录 source ${install_root}/cann/set_env.sh export ASCEND_INSTALL_PATH=${install_root}/cann # ${ascend_name} 替换为昇腾 AI 处理器型号，可通过 npu-smi info 查看 Name 字段并去掉空格获得 export SOC_VERSION=${ascend_name} # ${cmake_path} 替换为 ascendc.cmake 所在目录，例如 ${install_root}/cann/aarch64-linux/tikcpp/ascendc_kernel_cmake export ASCENDC_CMAKE_DIR=${cmake_path}` 如果未提前设置环境变量，`run.sh` 会自动尝试探测 `ASCEND_INSTALL_PATH`、`ASCEND_HOME_PATH`、`$HOME/Ascend/cann`、`/usr/local/Ascend/cann`、`/opt/Ascend/cann`、`SOC_VERSION` 和 `ASCENDC_CMAKE_DIR`；如果自动探测失败，请按上述命令手动设置。本样例的数据生成与结果校验依赖 `numpy`，执行 `run.sh` 前请确保 Python 环境已安装 `numpy`。 3. 执行以下命令运行样例。 `bash bash run.sh` 预期结果： `text Configuring CMake... Building... ... [INFO] Run the uvm_allocate sample successfully. ... output/output_z.bin ... output/golden.bin error ratio: 0.0000, tolerance: 0.0010 [SUCCESS] result correct` ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!3131	22 days ago
4_reliability	【PR】:优化 Runtime 样例可执行性与文档一致性 Co-authored-by: shi-qiong<shiqiong3@huawei.com> # message auto-generated for no-merge-commit merge: !3236 merge feature/runtime-example-usability-fixes into master 【PR】:优化 Runtime 样例可执行性与文档一致性 Created-by: shi-qiong Commit-by: shi-qiong Merged-by: cann-robot Description: # Pull Request ## 描述本次 PR 主要优化 Runtime example 的文档一致性、运行步骤完整性和自动化执行友好性，降低样例运行和评估过程中的误判风险。 \| 编号 \| 级别 \| 描述 \| 建议 \| \|------\|------\|------\|------\| \| 1 \| 严重 \| `5_performance/profiling/3_mstx_with_domain/README.md` 疑似从 toolkit 仓错误搬运：引用 `sample_run.sh`（实际为 `run.sh`）、安装路径指向 `/usr/local/Ascend/ascend-toolkit/8.x.x/tools/mstx/samples`、表格链接 `./mstx_with_domain` 子目录不存在（实际为同级 cpp 文件），与 CMakeLists.txt+run.sh 工程结构不符 \| 按本仓实际工程结构重写该 README，对齐全仓统一的"编译运行"小节格式 \| \| 2 \| 一般 \| 4 处失败链接：`4_reliability/README.md`→`snapshot/`（目录缺失）、`4_reliability/fault_tolerant/README.md`→`../snapshot/`、`2_advanced_features/notify/README.md`→`2_cntnotify`（目录缺失）、`3_mstx_with_domain` 表格链接 \| 删除失效链接，或补齐对应目录/用例 \| \| 3 \| 一般 \| 31 个用例 README 环境配置步骤不完整：2/3/4/5 模块普遍改用手动 `export SOC_VERSION`，未提及 `set_sample_env.sh`，与 1_basic_features（全部使用 set_sample_env.sh）方案并存，文档体系不统一 \| 全仓统一环境配置方式，推荐统一采用 `source set_sample_env.sh` 并在所有用例 README 写全 4 步骤 \| \| 4 \| 一般 \| 设备复位接口不一致：`ipcevent/0_ipcevent`、`ipcevent/1_ipcevent_multi_device` 使用 `aclrtResetDevice`，其余 50 个用例统一使用 `aclrtResetDeviceForce` \| 统一为 `aclrtResetDeviceForce` 或在 README 注明差异原因 \| \| 5 \| 一般 \| 10 个 memory 用例的示例输出夹带伪版本号 `CANN Version: 1.0.0, TimeStamp: ...`，与真实 CANN 版本（9.1.0）不符，且位置不统一 \| 清理示例输出中的占位版本号 \| \| 6 \| 提示 \| `ipcevent/1_ipcevent_multi_device` 在设备数不足时 exit 1，易被自动化框架误判为 FAIL \| 启动前调用 `aclrtGetDeviceCount` 预检，不满足时优雅退出（exit 0 + SKIP 提示） \| \| 7 \| 提示 \| 22 个 advanced/performance 用例缺少「示例输出」小节 \| 补充各用例的预期运行输出 \| \| 8 \| 提示 \| `0_quickstart/0_hello_cann` README 文字"快速入门示示例"（"示例"重复）；`stream/0_simple_stream` 输出"beging assigning task"拼写错误 \| 修正文字笔误 \| \| 9 \| 提示 \| 产品支持表口径不一致：quickstart/1_basic_features 含"Ascend 950PR/950DT"，2/3/4/5 仅列 Atlas A3/A2，差异未说明 \| 统一产品支持表口径或补注差异原因 \| 主要变更包括： - 修正部分 README 中错误链接、错误脚本名、错误路径和示例表格链接。 - 统一部分 advanced/performance 样例的环境配置说明，补充 `set_sample_env.sh` 使用方式。 - 为缺少示例输出的样例补充「示例输出」小节。 - 移除 memory 样例输出中的伪 CANN 版本号。 - 修复 quickstart/stream 文档与输出中的文字拼写问题。 - 为 `ipcevent/1_ipcevent_multi_device` 增加设备数预检，设备不足时以 SKIP 方式优雅退出，避免自动化框架误判为 FAIL。 - 补充产品支持表说明和 Device 复位接口使用约定。 - 调整 `3_mstx_with_domain` 样例 README、run.sh 和代码，使其与实际工程结构一致。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [x] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试描述测试此变更的步骤和前提条件： 1. 执行 `git diff --check`，确认无空白格式问题。 2. 执行修改后的样例验证，确认 `3_mstx_with_domain` 可正常编译运行。 3. 执行 `ipcevent/1_ipcevent_multi_device`，在设备数不足场景下确认输出 SKIP 提示并返回 0。 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息本次修改聚焦 Runtime example 易用性整改，未包含本地评估报告目录和辅助 skill 目录。 See merge request: cann/runtime!3236	22 days ago
5_performance	【PR】:优化 Runtime 样例可执行性与文档一致性 Co-authored-by: shi-qiong<shiqiong3@huawei.com> # message auto-generated for no-merge-commit merge: !3236 merge feature/runtime-example-usability-fixes into master 【PR】:优化 Runtime 样例可执行性与文档一致性 Created-by: shi-qiong Commit-by: shi-qiong Merged-by: cann-robot Description: # Pull Request ## 描述本次 PR 主要优化 Runtime example 的文档一致性、运行步骤完整性和自动化执行友好性，降低样例运行和评估过程中的误判风险。 \| 编号 \| 级别 \| 描述 \| 建议 \| \|------\|------\|------\|------\| \| 1 \| 严重 \| `5_performance/profiling/3_mstx_with_domain/README.md` 疑似从 toolkit 仓错误搬运：引用 `sample_run.sh`（实际为 `run.sh`）、安装路径指向 `/usr/local/Ascend/ascend-toolkit/8.x.x/tools/mstx/samples`、表格链接 `./mstx_with_domain` 子目录不存在（实际为同级 cpp 文件），与 CMakeLists.txt+run.sh 工程结构不符 \| 按本仓实际工程结构重写该 README，对齐全仓统一的"编译运行"小节格式 \| \| 2 \| 一般 \| 4 处失败链接：`4_reliability/README.md`→`snapshot/`（目录缺失）、`4_reliability/fault_tolerant/README.md`→`../snapshot/`、`2_advanced_features/notify/README.md`→`2_cntnotify`（目录缺失）、`3_mstx_with_domain` 表格链接 \| 删除失效链接，或补齐对应目录/用例 \| \| 3 \| 一般 \| 31 个用例 README 环境配置步骤不完整：2/3/4/5 模块普遍改用手动 `export SOC_VERSION`，未提及 `set_sample_env.sh`，与 1_basic_features（全部使用 set_sample_env.sh）方案并存，文档体系不统一 \| 全仓统一环境配置方式，推荐统一采用 `source set_sample_env.sh` 并在所有用例 README 写全 4 步骤 \| \| 4 \| 一般 \| 设备复位接口不一致：`ipcevent/0_ipcevent`、`ipcevent/1_ipcevent_multi_device` 使用 `aclrtResetDevice`，其余 50 个用例统一使用 `aclrtResetDeviceForce` \| 统一为 `aclrtResetDeviceForce` 或在 README 注明差异原因 \| \| 5 \| 一般 \| 10 个 memory 用例的示例输出夹带伪版本号 `CANN Version: 1.0.0, TimeStamp: ...`，与真实 CANN 版本（9.1.0）不符，且位置不统一 \| 清理示例输出中的占位版本号 \| \| 6 \| 提示 \| `ipcevent/1_ipcevent_multi_device` 在设备数不足时 exit 1，易被自动化框架误判为 FAIL \| 启动前调用 `aclrtGetDeviceCount` 预检，不满足时优雅退出（exit 0 + SKIP 提示） \| \| 7 \| 提示 \| 22 个 advanced/performance 用例缺少「示例输出」小节 \| 补充各用例的预期运行输出 \| \| 8 \| 提示 \| `0_quickstart/0_hello_cann` README 文字"快速入门示示例"（"示例"重复）；`stream/0_simple_stream` 输出"beging assigning task"拼写错误 \| 修正文字笔误 \| \| 9 \| 提示 \| 产品支持表口径不一致：quickstart/1_basic_features 含"Ascend 950PR/950DT"，2/3/4/5 仅列 Atlas A3/A2，差异未说明 \| 统一产品支持表口径或补注差异原因 \| 主要变更包括： - 修正部分 README 中错误链接、错误脚本名、错误路径和示例表格链接。 - 统一部分 advanced/performance 样例的环境配置说明，补充 `set_sample_env.sh` 使用方式。 - 为缺少示例输出的样例补充「示例输出」小节。 - 移除 memory 样例输出中的伪 CANN 版本号。 - 修复 quickstart/stream 文档与输出中的文字拼写问题。 - 为 `ipcevent/1_ipcevent_multi_device` 增加设备数预检，设备不足时以 SKIP 方式优雅退出，避免自动化框架误判为 FAIL。 - 补充产品支持表说明和 Device 复位接口使用约定。 - 调整 `3_mstx_with_domain` 样例 README、run.sh 和代码，使其与实际工程结构一致。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [x] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试描述测试此变更的步骤和前提条件： 1. 执行 `git diff --check`，确认无空白格式问题。 2. 执行修改后的样例验证，确认 `3_mstx_with_domain` 可正常编译运行。 3. 执行 `ipcevent/1_ipcevent_multi_device`，在设备数不足场景下确认输出 SKIP 提示并返回 0。 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息本次修改聚焦 Runtime example 易用性整改，未包含本地评估报告目录和辅助 skill 目录。 See merge request: cann/runtime!3236	22 days ago
6_scenarios	fix(example): 修复 README 失效链接(#667) Co-authored-by: nevermore_t<tianjingxuan2@huawei.com> # message auto-generated for no-merge-commit merge: !3220 merge fix/issue-667-broken-links into master fix(example): 修复 README 失效链接(#667) Created-by: nevermore_t Commit-by: nevermore_t Merged-by: cann-robot Description: ## 描述修复 issue #667 报告的 README 失效链接。 PR !1608 删除了 `2_cntnotify` 和 `snapshot` 两个样例目录（A2/A3 不支持 cntnotify 接口，snapshot 为试验接口后续 950 已不支持），但未同步清理父目录 README 中的引用链接，导致死链。本次变更： - 删除 `notify/README.md` 中指向已删除的 `2_cntnotify` 的链接 - 删除 `fault_tolerant/README.md` 中指向已删除的 `snapshot` 的链接 - 统一 11 个 README 的 section title："可先参考"→"可选参考"（更符合作为标题的语义，英文版对应 `References`） ## 变更类型 - [x] 📝 文档内容更新 ## 关联的Issue #667 ## 如何测试 1. 确认 `example/2_advanced_features/notify/` 下不再有 `2_cntnotify` 目录引用 2. 确认 `example/4_reliability/` 下不再有 `snapshot` 目录引用 3. 确认所有保留的链接指向的目录存在 4. `grep -r "可先参考" example/` 返回空（已全部替换为"可选参考"） ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定 See merge request: cann/runtime!3220	23 days ago
common	【PR】: resolve_cann_env.sh增加"set -e" Co-authored-by: Reyn52166<leihuan1@huawei.com> # message auto-generated for no-merge-commit merge: !3041 merge master into master 【PR】: resolve_cann_env.sh增加"set -e" Created-by: Reyn52166 Commit-by: Reyn52166 Merged-by: cann-robot Description: # Pull Request ## 描述 resolve_cann_env.sh增加"set -e" ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [x] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [ ] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> NA ## 如何测试不涉及功能 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!3041	29 days ago
kernel_func	优化example目录结构易用性及补充用例 Co-authored-by: qiang_zq<qiang.zhangqiang@huawei.com> # message auto-generated for no-merge-commit merge: !1163 merge sample into master 优化example目录结构易用性及补充用例 Created-by: qiang_zq Commit-by: qiang_zq Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1、example 目录结构优化，按学习阶段重新组织目录结构(0_quickstart ~ 6_scenarios) 2、补充部分API的example用例 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #000--> https://gitcode.com/cann/runtime/issues/284 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 部分用例执行过程 source /home/developer/Ascend/cann/set_env.sh && export SOC_VERSION=ascend910b3 && export ASCENDC_CMAKE_DIR=/home/developer/Ascend/cann/aarch64-linux/tikcpp/ascendc_kernel_cmake && export ASCEND_INSTALL_PATH=/home/developer/Ascend/cann && cd /mnt/workspace/gitCode/qiang_zq/runtime/example/3_memory_advanced/allocator/0_custom_allocator && rm -rf build && dos2unix run.sh 2>/dev/null \|\| sed -i 's/\\r$//' run.sh && bash run.sh Configuring CMake... -- The C compiler identification is GNU 13.3.0 -- The CXX compiler identification is GNU 13.3.0 -- Detecting C compiler ABI info -- Detecting C compiler ABI info - done -- Check for working C compiler: /usr/bin/cc - skipped -- Detecting C compile features -- Detecting C compile features - done -- Detecting CXX compiler ABI info -- Detecting CXX compiler ABI info - done -- Check for working CXX compiler: /usr/bin/c++ - skipped -- Detecting CXX compile features -- Detecting CXX compile features - done -- Configuring done -- Generating done -- Build files have been written to: /mnt/workspace/gitCode/qiang_zq/runtime/example/3_memory_advanced/allocator/0_custom_allocator/build Building... [ 50%] Building CXX object CMakeFiles/main.dir/main.cpp.o [100%] Linking CXX executable main [100%] Built target main Build completed successfully! Executable location: /mnt/workspace/gitCode/qiang_zq/runtime/example/3_memory_advanced/allocator/0_custom_allocator/build/main Run the sample: ./build/main ./build/main [INFO] CustomAlloc size=256 [INFO] CustomAllocAdvise size=128 [INFO] CustomAlloc size=128 [INFO] CustomFree invoked [INFO] CustomFree invoked [INFO] Allocator desc queried: descOut=0xaaaabd6a3780 allocCount=2 freeCount=2 用例执行报告 0_quickstart (3/3) ✅ ✅ 0_hello_cann ✅ 1_error_handling ✅ 2_system_info 1_basic_features (23/23) ✅ ✅ device/0_device_normal ✅ device/1_device_multi_thread ✅ device/2_device_P2P ✅ event/0_event_status ✅ event/1_event_timestamp ✅ memory/0_h2h_memory_copy ✅ memory/10_ipc_memory_withpid ✅ memory/11_ipc_memory_withoutpid ✅ memory/1_h2d_sync_memory_copy ✅ memory/2_h2d_async_memory_copy ✅ memory/3_d2h_sync_memory_copy ✅ memory/4_d2h_async_memory_copy ✅ memory/5_d2d_sync_memory_copy ✅ memory/6_d2d_async_memory_copy ✅ memory/7_physical_memory_sharing_withpid ✅ memory/8_physical_memory_sharing_withoutpid ✅ memory/9_multistream_sync_memory ✅ stream/0_simple_stream ✅ stream/1_stream_with_failure_mode ✅ stream/2_multi_stream 2_advanced_features (17/17) ✅ ✅ built_in_task/0_reduce_task ✅ built_in_task/1_random_num_task ✅ callback/0_simple_callback ✅ callback/1_callback_hostfunc ✅ callback/2_callback_exception ✅ group/0_compute_group ✅ kernel/0_launch_kernel ✅ kernel/1_launch_kernel_with_reslimit ✅ label/0_simple_label ✅ model_ri/0_simple_model ✅ model_ri/1_model_update ✅ model_ri/2_model_switch ✅ notify/0_ipc_notify_withpid ✅ notify/1_ipc_notify_withoutpid ✅ notify/2_cntnotify ✅ tdt_buffer/0_shared_buffer ✅ tdt_channel/0_simple_channel ✅ tdt_channel/1_channel_capacity ✅ tdt_queue/0_simple_queue ✅ tdt_queue/1_queue_route ✅ tdt_queue/2_queue_grant_attach 3_memory_advanced (1/1) ✅ ✅ allocator/0_custom_allocator 4_reliability (2/2) ✅ ✅ overflow_detection/0_overflow_detection ✅ snapshot/0_snapshot_management 5_performance (6/6) ✅ ✅ adump/0_adump_args ✅ adump/1_adump_callback ✅ adump/2_model_dump_config ✅ profiling/0_create_config ✅ profiling/1_msproftx ✅ profiling/2_subscribe_model ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> docs/02_dev_guide/初始化.md example/*.md ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/runtime!1163	3 months ago
tools	【PR】: fix: sample 易用性规范性优化 Co-authored-by: qiang_zq<qiang.zhangqiang@huawei.com> # message auto-generated for no-merge-commit merge: !2067 merge master into master 【PR】: fix: sample 易用性规范性优化 Created-by: qiang_zq Commit-by: qiang_zq Merged-by: cann-robot Description: # Pull Request ## 描述 1、sample样例 readme规范化整改 2、sample样例补充优化注释 3、sample样例 cmakelist 连接包优化，libascendcl.so -> libacl_rt.so 4、新增一键导入 SOC_VERSION和ASCENDC_CMAKE_DIR变量的工具 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [x] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试描述测试此变更的步骤和前提条件： 1. example/0_quickstart/4_custom_kernel_launch `Vector addition result: result[0] = 1.5 (expected: 1.5) result[1] = 3.0 (expected: 3.0) result[2] = 4.5 (expected: 4.5) result[3] = 6.0 (expected: 6.0) result[4] = 7.5 (expected: 7.5) result[5] = 9.0 (expected: 9.0) result[6] = 10.5 (expected: 10.5) result[7] = 12.0 (expected: 12.0) Free device memory successfully Destroy stream successfully Reset device successfully ACL finalize successfully Sample run successfully with <<<>>> kernel call!` 2. 样例执行验证 ===== START 0_quickstart/0_hello_cann ===== RESULT 0_quickstart/0_hello_cann rc=0 -- Check for working CXX compiler: /usr/bin/c++ - skipped -- Detecting CXX compile features -- Detecting CXX compile features - done -- Configuring done -- Generating done -- Build files have been written to: /mnt/workspace/gitCode/qiang_zq/runtime/example/0_quickstart/0_hello_cann/build Building... [ 50%] Building CXX object CMakeFiles/main.dir/main.cpp.o [100%] Linking CXX executable main [100%] Built target main Build completed successfully! Executable location: /mnt/workspace/gitCode/qiang_zq/runtime/example/0_quickstart/0_hello_cann/build/main Run the sample: ./build/main ACL init successfully Set device 0 successfully Create stream successfully Input vectors: self: [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0] other: [0.5, 1.0, 1.5, 2.0, 2.5, 3.0, 3.5, 4.0] alpha: 1.0 Create output aclDataBuffer successfully, buffer addr = 0x12e0c0016000 Get workspace size successfully, workspace size = 0 Launch aclnnAdd successfully Synchronize stream successfully Vector addition result: result[0] = 1.5 (expected: 1.5) result[1] = 3.0 (expected: 3.0) result[2] = 4.5 (expected: 4.5) result[3] = 6.0 (expected: 6.0) result[4] = 7.5 (expected: 7.5) result[5] = 9.0 (expected: 9.0) result[6] = 10.5 (expected: 10.5) result[7] = 12.0 (expected: 12.0) Free device memory successfully Destroy stream successfully Reset device successfully ACL finalize successfully Sample run successfully! ===== END 0_quickstart/0_hello_cann ===== ===== START 0_quickstart/1_error_handling ===== RESULT 0_quickstart/1_error_handling rc=0 Configuring CMake... -- The C compiler identification is GNU 13.3.0 -- The CXX compiler identification is GNU 13.3.0 -- Detecting C compiler ABI info -- Detecting C compiler ABI info - done -- Check for working C compiler: /usr/bin/cc - skipped -- Detecting C compile features -- Detecting C compile features - done -- Detecting CXX compiler ABI info -- Detecting CXX compiler ABI info - done -- Check for working CXX compiler: /usr/bin/c++ - skipped -- Detecting CXX compile features -- Detecting CXX compile features - done -- Configuring done -- Generating done -- Build files have been written to: /mnt/workspace/gitCode/qiang_zq/runtime/example/0_quickstart/1_error_handling/build Building... [ 50%] Building CXX object CMakeFiles/main.dir/main.cpp.o [100%] Linking CXX executable main [100%] Built target main Build completed successfully! Executable location: /mnt/workspace/gitCode/qiang_zq/runtime/example/0_quickstart/1_error_handling/build/main Run the sample: ./build/main [INFO] ACL init and set device successfully [INFO] Current run mode: ACL_HOST [INFO] Triggering an expected invalid-parameter error with aclrtGetRunMode(nullptr) [ERROR] Diagnostics: ret=100000, peekErr=0, lastErr=0, recentErrMsg=[PID: 334883] 2026-05-12-16:34:08.984.159 Invalid_Argument_Null_Pointer(EH0002): Argument [runMode] must not be null. Solution: Try again with a correct pointer argument. [WARN] aclrtGetErrorVerbose(0) returned error code 207000 [INFO] After diagnostics are consumed once: peekErr=207000, lastErr=207000, recentErrMsg=<null> [INFO] ACL finalize successfully ===== END 0_quickstart/1_error_handling ===== ===== START 0_quickstart/2_system_info ===== RESULT 0_quickstart/2_system_info rc=0 Configuring CMake... -- The C compiler identification is GNU 13.3.0 -- The CXX compiler identification is GNU 13.3.0 -- Detecting C compiler ABI info -- Detecting C compiler ABI info - done -- Check for working C compiler: /usr/bin/cc - skipped -- Detecting C compile features -- Detecting C compile features - done -- Detecting CXX compiler ABI info -- Detecting CXX compiler ABI info - done -- Check for working CXX compiler: /usr/bin/c++ - skipped -- Detecting CXX compile features -- Detecting CXX compile features - done -- Configuring done -- Generating done -- Build files have been written to: /mnt/workspace/gitCode/qiang_zq/runtime/example/0_quickstart/2_system_info/build Building... [ 50%] Building CXX object CMakeFiles/main.dir/main.cpp.o [100%] Linking CXX executable main [100%] Built target main Build completed successfully! Executable location: /mnt/workspace/gitCode/qiang_zq/runtime/example/0_quickstart/2_system_info/build/main Run the sample: ./build/main [INFO] ACL init successfully [INFO] ACL Runtime API version: 1.16.0 [INFO] CANN package [runtime] version string: 9.0.0 [INFO] CANN package [runtime] version number: 90000000 [INFO] Current run mode: ACL_HOST [INFO] Float conversion: 1.625000 -> 0x3e80 -> 1.625000 [INFO] Data type size: ACL_FLOAT=4, ACL_FLOAT16=2, ACL_INT64=8 [INFO] ACL finalize successfully ===== END 0_quickstart/2_system_info ===== ===== START 1_basic_features/device/0_device_normal ===== RESULT 1_basic_features/device/0_device_normal rc=0 [INFO]: Current compile soc version is ascend910_9362 -- The C compiler identification is GNU 13.3.0 -- The CXX compiler identification is GNU 13.3.0 -- Detecting C compiler ABI info -- Detecting C compiler ABI info - done -- Check for working C compiler: /usr/bin/cc - skipped -- Detecting C compile features -- Detecting C compile features - done -- Detecting CXX compiler ABI info -- Detecting CXX compiler ABI info - done -- Check for working CXX compiler: /usr/bin/c++ - skipped -- Detecting CXX compile features -- Detecting CXX compile features - done -- Configuring done -- Generating done -- Build files have been written to: /mnt/workspace/gitCode/qiang_zq/runtime/example/1_basic_features/device/0_device_normal/build [ 50%] Building CXX object CMakeFiles/main.dir/main.cpp.o [100%] Linking CXX executable main [100%] Built target main -- Install configuration: \"Debug\" [INFO] Start to run device_normal sample. [INFO] result[0] is: 1.200000 [INFO] result[1] is: 2.200000 [INFO] result[2] is: 3.200000 [INFO] result[3] is: 5.400000 [INFO] result[4] is: 6.400000 [INFO] result[5] is: 7.400000 [INFO] result[6] is: 9.600000 [INFO] result[7] is: 10.600000 [INFO] Run the device_normal sample successfully. ===== END 1_basic_features/device/0_device_normal ===== ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!2067	2 months ago
.gitignore	Initial commit	6 months ago
README.md	【PR】:优化 Runtime 样例可执行性与文档一致性 Co-authored-by: shi-qiong<shiqiong3@huawei.com> # message auto-generated for no-merge-commit merge: !3236 merge feature/runtime-example-usability-fixes into master 【PR】:优化 Runtime 样例可执行性与文档一致性 Created-by: shi-qiong Commit-by: shi-qiong Merged-by: cann-robot Description: # Pull Request ## 描述本次 PR 主要优化 Runtime example 的文档一致性、运行步骤完整性和自动化执行友好性，降低样例运行和评估过程中的误判风险。 \| 编号 \| 级别 \| 描述 \| 建议 \| \|------\|------\|------\|------\| \| 1 \| 严重 \| `5_performance/profiling/3_mstx_with_domain/README.md` 疑似从 toolkit 仓错误搬运：引用 `sample_run.sh`（实际为 `run.sh`）、安装路径指向 `/usr/local/Ascend/ascend-toolkit/8.x.x/tools/mstx/samples`、表格链接 `./mstx_with_domain` 子目录不存在（实际为同级 cpp 文件），与 CMakeLists.txt+run.sh 工程结构不符 \| 按本仓实际工程结构重写该 README，对齐全仓统一的"编译运行"小节格式 \| \| 2 \| 一般 \| 4 处失败链接：`4_reliability/README.md`→`snapshot/`（目录缺失）、`4_reliability/fault_tolerant/README.md`→`../snapshot/`、`2_advanced_features/notify/README.md`→`2_cntnotify`（目录缺失）、`3_mstx_with_domain` 表格链接 \| 删除失效链接，或补齐对应目录/用例 \| \| 3 \| 一般 \| 31 个用例 README 环境配置步骤不完整：2/3/4/5 模块普遍改用手动 `export SOC_VERSION`，未提及 `set_sample_env.sh`，与 1_basic_features（全部使用 set_sample_env.sh）方案并存，文档体系不统一 \| 全仓统一环境配置方式，推荐统一采用 `source set_sample_env.sh` 并在所有用例 README 写全 4 步骤 \| \| 4 \| 一般 \| 设备复位接口不一致：`ipcevent/0_ipcevent`、`ipcevent/1_ipcevent_multi_device` 使用 `aclrtResetDevice`，其余 50 个用例统一使用 `aclrtResetDeviceForce` \| 统一为 `aclrtResetDeviceForce` 或在 README 注明差异原因 \| \| 5 \| 一般 \| 10 个 memory 用例的示例输出夹带伪版本号 `CANN Version: 1.0.0, TimeStamp: ...`，与真实 CANN 版本（9.1.0）不符，且位置不统一 \| 清理示例输出中的占位版本号 \| \| 6 \| 提示 \| `ipcevent/1_ipcevent_multi_device` 在设备数不足时 exit 1，易被自动化框架误判为 FAIL \| 启动前调用 `aclrtGetDeviceCount` 预检，不满足时优雅退出（exit 0 + SKIP 提示） \| \| 7 \| 提示 \| 22 个 advanced/performance 用例缺少「示例输出」小节 \| 补充各用例的预期运行输出 \| \| 8 \| 提示 \| `0_quickstart/0_hello_cann` README 文字"快速入门示示例"（"示例"重复）；`stream/0_simple_stream` 输出"beging assigning task"拼写错误 \| 修正文字笔误 \| \| 9 \| 提示 \| 产品支持表口径不一致：quickstart/1_basic_features 含"Ascend 950PR/950DT"，2/3/4/5 仅列 Atlas A3/A2，差异未说明 \| 统一产品支持表口径或补注差异原因 \| 主要变更包括： - 修正部分 README 中错误链接、错误脚本名、错误路径和示例表格链接。 - 统一部分 advanced/performance 样例的环境配置说明，补充 `set_sample_env.sh` 使用方式。 - 为缺少示例输出的样例补充「示例输出」小节。 - 移除 memory 样例输出中的伪 CANN 版本号。 - 修复 quickstart/stream 文档与输出中的文字拼写问题。 - 为 `ipcevent/1_ipcevent_multi_device` 增加设备数预检，设备不足时以 SKIP 方式优雅退出，避免自动化框架误判为 FAIL。 - 补充产品支持表说明和 Device 复位接口使用约定。 - 调整 `3_mstx_with_domain` 样例 README、run.sh 和代码，使其与实际工程结构一致。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [x] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试描述测试此变更的步骤和前提条件： 1. 执行 `git diff --check`，确认无空白格式问题。 2. 执行修改后的样例验证，确认 `3_mstx_with_domain` 可正常编译运行。 3. 执行 `ipcevent/1_ipcevent_multi_device`，在设备数不足场景下确认输出 SKIP 提示并返回 0。 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息本次修改聚焦 Runtime example 易用性整改，未包含本地评估报告目录和辅助 skill 目录。 See merge request: cann/runtime!3236	22 days ago
README_en.md	【PR】:优化 Runtime 样例可执行性与文档一致性 Co-authored-by: shi-qiong<shiqiong3@huawei.com> # message auto-generated for no-merge-commit merge: !3236 merge feature/runtime-example-usability-fixes into master 【PR】:优化 Runtime 样例可执行性与文档一致性 Created-by: shi-qiong Commit-by: shi-qiong Merged-by: cann-robot Description: # Pull Request ## 描述本次 PR 主要优化 Runtime example 的文档一致性、运行步骤完整性和自动化执行友好性，降低样例运行和评估过程中的误判风险。 \| 编号 \| 级别 \| 描述 \| 建议 \| \|------\|------\|------\|------\| \| 1 \| 严重 \| `5_performance/profiling/3_mstx_with_domain/README.md` 疑似从 toolkit 仓错误搬运：引用 `sample_run.sh`（实际为 `run.sh`）、安装路径指向 `/usr/local/Ascend/ascend-toolkit/8.x.x/tools/mstx/samples`、表格链接 `./mstx_with_domain` 子目录不存在（实际为同级 cpp 文件），与 CMakeLists.txt+run.sh 工程结构不符 \| 按本仓实际工程结构重写该 README，对齐全仓统一的"编译运行"小节格式 \| \| 2 \| 一般 \| 4 处失败链接：`4_reliability/README.md`→`snapshot/`（目录缺失）、`4_reliability/fault_tolerant/README.md`→`../snapshot/`、`2_advanced_features/notify/README.md`→`2_cntnotify`（目录缺失）、`3_mstx_with_domain` 表格链接 \| 删除失效链接，或补齐对应目录/用例 \| \| 3 \| 一般 \| 31 个用例 README 环境配置步骤不完整：2/3/4/5 模块普遍改用手动 `export SOC_VERSION`，未提及 `set_sample_env.sh`，与 1_basic_features（全部使用 set_sample_env.sh）方案并存，文档体系不统一 \| 全仓统一环境配置方式，推荐统一采用 `source set_sample_env.sh` 并在所有用例 README 写全 4 步骤 \| \| 4 \| 一般 \| 设备复位接口不一致：`ipcevent/0_ipcevent`、`ipcevent/1_ipcevent_multi_device` 使用 `aclrtResetDevice`，其余 50 个用例统一使用 `aclrtResetDeviceForce` \| 统一为 `aclrtResetDeviceForce` 或在 README 注明差异原因 \| \| 5 \| 一般 \| 10 个 memory 用例的示例输出夹带伪版本号 `CANN Version: 1.0.0, TimeStamp: ...`，与真实 CANN 版本（9.1.0）不符，且位置不统一 \| 清理示例输出中的占位版本号 \| \| 6 \| 提示 \| `ipcevent/1_ipcevent_multi_device` 在设备数不足时 exit 1，易被自动化框架误判为 FAIL \| 启动前调用 `aclrtGetDeviceCount` 预检，不满足时优雅退出（exit 0 + SKIP 提示） \| \| 7 \| 提示 \| 22 个 advanced/performance 用例缺少「示例输出」小节 \| 补充各用例的预期运行输出 \| \| 8 \| 提示 \| `0_quickstart/0_hello_cann` README 文字"快速入门示示例"（"示例"重复）；`stream/0_simple_stream` 输出"beging assigning task"拼写错误 \| 修正文字笔误 \| \| 9 \| 提示 \| 产品支持表口径不一致：quickstart/1_basic_features 含"Ascend 950PR/950DT"，2/3/4/5 仅列 Atlas A3/A2，差异未说明 \| 统一产品支持表口径或补注差异原因 \| 主要变更包括： - 修正部分 README 中错误链接、错误脚本名、错误路径和示例表格链接。 - 统一部分 advanced/performance 样例的环境配置说明，补充 `set_sample_env.sh` 使用方式。 - 为缺少示例输出的样例补充「示例输出」小节。 - 移除 memory 样例输出中的伪 CANN 版本号。 - 修复 quickstart/stream 文档与输出中的文字拼写问题。 - 为 `ipcevent/1_ipcevent_multi_device` 增加设备数预检，设备不足时以 SKIP 方式优雅退出，避免自动化框架误判为 FAIL。 - 补充产品支持表说明和 Device 复位接口使用约定。 - 调整 `3_mstx_with_domain` 样例 README、run.sh 和代码，使其与实际工程结构一致。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [x] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试描述测试此变更的步骤和前提条件： 1. 执行 `git diff --check`，确认无空白格式问题。 2. 执行修改后的样例验证，确认 `3_mstx_with_domain` 可正常编译运行。 3. 执行 `ipcevent/1_ipcevent_multi_device`，在设备数不足场景下确认输出 SKIP 提示并返回 0。 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息本次修改聚焦 Runtime example 易用性整改，未包含本地评估报告目录和辅助 skill 目录。 See merge request: cann/runtime!3236	22 days ago
runtime_init_utils.h	优化example目录结构易用性及补充用例 Co-authored-by: qiang_zq<qiang.zhangqiang@huawei.com> # message auto-generated for no-merge-commit merge: !1163 merge sample into master 优化example目录结构易用性及补充用例 Created-by: qiang_zq Commit-by: qiang_zq Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1、example 目录结构优化，按学习阶段重新组织目录结构(0_quickstart ~ 6_scenarios) 2、补充部分API的example用例 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #000--> https://gitcode.com/cann/runtime/issues/284 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 部分用例执行过程 source /home/developer/Ascend/cann/set_env.sh && export SOC_VERSION=ascend910b3 && export ASCENDC_CMAKE_DIR=/home/developer/Ascend/cann/aarch64-linux/tikcpp/ascendc_kernel_cmake && export ASCEND_INSTALL_PATH=/home/developer/Ascend/cann && cd /mnt/workspace/gitCode/qiang_zq/runtime/example/3_memory_advanced/allocator/0_custom_allocator && rm -rf build && dos2unix run.sh 2>/dev/null \|\| sed -i 's/\\r$//' run.sh && bash run.sh Configuring CMake... -- The C compiler identification is GNU 13.3.0 -- The CXX compiler identification is GNU 13.3.0 -- Detecting C compiler ABI info -- Detecting C compiler ABI info - done -- Check for working C compiler: /usr/bin/cc - skipped -- Detecting C compile features -- Detecting C compile features - done -- Detecting CXX compiler ABI info -- Detecting CXX compiler ABI info - done -- Check for working CXX compiler: /usr/bin/c++ - skipped -- Detecting CXX compile features -- Detecting CXX compile features - done -- Configuring done -- Generating done -- Build files have been written to: /mnt/workspace/gitCode/qiang_zq/runtime/example/3_memory_advanced/allocator/0_custom_allocator/build Building... [ 50%] Building CXX object CMakeFiles/main.dir/main.cpp.o [100%] Linking CXX executable main [100%] Built target main Build completed successfully! Executable location: /mnt/workspace/gitCode/qiang_zq/runtime/example/3_memory_advanced/allocator/0_custom_allocator/build/main Run the sample: ./build/main ./build/main [INFO] CustomAlloc size=256 [INFO] CustomAllocAdvise size=128 [INFO] CustomAlloc size=128 [INFO] CustomFree invoked [INFO] CustomFree invoked [INFO] Allocator desc queried: descOut=0xaaaabd6a3780 allocCount=2 freeCount=2 用例执行报告 0_quickstart (3/3) ✅ ✅ 0_hello_cann ✅ 1_error_handling ✅ 2_system_info 1_basic_features (23/23) ✅ ✅ device/0_device_normal ✅ device/1_device_multi_thread ✅ device/2_device_P2P ✅ event/0_event_status ✅ event/1_event_timestamp ✅ memory/0_h2h_memory_copy ✅ memory/10_ipc_memory_withpid ✅ memory/11_ipc_memory_withoutpid ✅ memory/1_h2d_sync_memory_copy ✅ memory/2_h2d_async_memory_copy ✅ memory/3_d2h_sync_memory_copy ✅ memory/4_d2h_async_memory_copy ✅ memory/5_d2d_sync_memory_copy ✅ memory/6_d2d_async_memory_copy ✅ memory/7_physical_memory_sharing_withpid ✅ memory/8_physical_memory_sharing_withoutpid ✅ memory/9_multistream_sync_memory ✅ stream/0_simple_stream ✅ stream/1_stream_with_failure_mode ✅ stream/2_multi_stream 2_advanced_features (17/17) ✅ ✅ built_in_task/0_reduce_task ✅ built_in_task/1_random_num_task ✅ callback/0_simple_callback ✅ callback/1_callback_hostfunc ✅ callback/2_callback_exception ✅ group/0_compute_group ✅ kernel/0_launch_kernel ✅ kernel/1_launch_kernel_with_reslimit ✅ label/0_simple_label ✅ model_ri/0_simple_model ✅ model_ri/1_model_update ✅ model_ri/2_model_switch ✅ notify/0_ipc_notify_withpid ✅ notify/1_ipc_notify_withoutpid ✅ notify/2_cntnotify ✅ tdt_buffer/0_shared_buffer ✅ tdt_channel/0_simple_channel ✅ tdt_channel/1_channel_capacity ✅ tdt_queue/0_simple_queue ✅ tdt_queue/1_queue_route ✅ tdt_queue/2_queue_grant_attach 3_memory_advanced (1/1) ✅ ✅ allocator/0_custom_allocator 4_reliability (2/2) ✅ ✅ overflow_detection/0_overflow_detection ✅ snapshot/0_snapshot_management 5_performance (6/6) ✅ ✅ adump/0_adump_args ✅ adump/1_adump_callback ✅ adump/2_model_dump_config ✅ profiling/0_create_config ✅ profiling/1_msproftx ✅ profiling/2_subscribe_model ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> docs/02_dev_guide/初始化.md example/*.md ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/runtime!1163	3 months ago
set_sample_env.sh	【PR】:优化 Runtime 样例可执行性与文档一致性 Co-authored-by: shi-qiong<shiqiong3@huawei.com> # message auto-generated for no-merge-commit merge: !3236 merge feature/runtime-example-usability-fixes into master 【PR】:优化 Runtime 样例可执行性与文档一致性 Created-by: shi-qiong Commit-by: shi-qiong Merged-by: cann-robot Description: # Pull Request ## 描述本次 PR 主要优化 Runtime example 的文档一致性、运行步骤完整性和自动化执行友好性，降低样例运行和评估过程中的误判风险。 \| 编号 \| 级别 \| 描述 \| 建议 \| \|------\|------\|------\|------\| \| 1 \| 严重 \| `5_performance/profiling/3_mstx_with_domain/README.md` 疑似从 toolkit 仓错误搬运：引用 `sample_run.sh`（实际为 `run.sh`）、安装路径指向 `/usr/local/Ascend/ascend-toolkit/8.x.x/tools/mstx/samples`、表格链接 `./mstx_with_domain` 子目录不存在（实际为同级 cpp 文件），与 CMakeLists.txt+run.sh 工程结构不符 \| 按本仓实际工程结构重写该 README，对齐全仓统一的"编译运行"小节格式 \| \| 2 \| 一般 \| 4 处失败链接：`4_reliability/README.md`→`snapshot/`（目录缺失）、`4_reliability/fault_tolerant/README.md`→`../snapshot/`、`2_advanced_features/notify/README.md`→`2_cntnotify`（目录缺失）、`3_mstx_with_domain` 表格链接 \| 删除失效链接，或补齐对应目录/用例 \| \| 3 \| 一般 \| 31 个用例 README 环境配置步骤不完整：2/3/4/5 模块普遍改用手动 `export SOC_VERSION`，未提及 `set_sample_env.sh`，与 1_basic_features（全部使用 set_sample_env.sh）方案并存，文档体系不统一 \| 全仓统一环境配置方式，推荐统一采用 `source set_sample_env.sh` 并在所有用例 README 写全 4 步骤 \| \| 4 \| 一般 \| 设备复位接口不一致：`ipcevent/0_ipcevent`、`ipcevent/1_ipcevent_multi_device` 使用 `aclrtResetDevice`，其余 50 个用例统一使用 `aclrtResetDeviceForce` \| 统一为 `aclrtResetDeviceForce` 或在 README 注明差异原因 \| \| 5 \| 一般 \| 10 个 memory 用例的示例输出夹带伪版本号 `CANN Version: 1.0.0, TimeStamp: ...`，与真实 CANN 版本（9.1.0）不符，且位置不统一 \| 清理示例输出中的占位版本号 \| \| 6 \| 提示 \| `ipcevent/1_ipcevent_multi_device` 在设备数不足时 exit 1，易被自动化框架误判为 FAIL \| 启动前调用 `aclrtGetDeviceCount` 预检，不满足时优雅退出（exit 0 + SKIP 提示） \| \| 7 \| 提示 \| 22 个 advanced/performance 用例缺少「示例输出」小节 \| 补充各用例的预期运行输出 \| \| 8 \| 提示 \| `0_quickstart/0_hello_cann` README 文字"快速入门示示例"（"示例"重复）；`stream/0_simple_stream` 输出"beging assigning task"拼写错误 \| 修正文字笔误 \| \| 9 \| 提示 \| 产品支持表口径不一致：quickstart/1_basic_features 含"Ascend 950PR/950DT"，2/3/4/5 仅列 Atlas A3/A2，差异未说明 \| 统一产品支持表口径或补注差异原因 \| 主要变更包括： - 修正部分 README 中错误链接、错误脚本名、错误路径和示例表格链接。 - 统一部分 advanced/performance 样例的环境配置说明，补充 `set_sample_env.sh` 使用方式。 - 为缺少示例输出的样例补充「示例输出」小节。 - 移除 memory 样例输出中的伪 CANN 版本号。 - 修复 quickstart/stream 文档与输出中的文字拼写问题。 - 为 `ipcevent/1_ipcevent_multi_device` 增加设备数预检，设备不足时以 SKIP 方式优雅退出，避免自动化框架误判为 FAIL。 - 补充产品支持表说明和 Device 复位接口使用约定。 - 调整 `3_mstx_with_domain` 样例 README、run.sh 和代码，使其与实际工程结构一致。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [x] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue 无。 ## 如何测试描述测试此变更的步骤和前提条件： 1. 执行 `git diff --check`，确认无空白格式问题。 2. 执行修改后的样例验证，确认 `3_mstx_with_domain` 可正常编译运行。 3. 执行 `ipcevent/1_ipcevent_multi_device`，在设备数不足场景下确认输出 SKIP 提示并返回 0。 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息本次修改聚焦 Runtime example 易用性整改，未包含本地评估报告目录和辅助 skill 目录。 See merge request: cann/runtime!3236	22 days ago
utils.h	优化example目录结构易用性及补充用例 Co-authored-by: qiang_zq<qiang.zhangqiang@huawei.com> # message auto-generated for no-merge-commit merge: !1163 merge sample into master 优化example目录结构易用性及补充用例 Created-by: qiang_zq Commit-by: qiang_zq Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1、example 目录结构优化，按学习阶段重新组织目录结构(0_quickstart ~ 6_scenarios) 2、补充部分API的example用例 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #000--> https://gitcode.com/cann/runtime/issues/284 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 部分用例执行过程 source /home/developer/Ascend/cann/set_env.sh && export SOC_VERSION=ascend910b3 && export ASCENDC_CMAKE_DIR=/home/developer/Ascend/cann/aarch64-linux/tikcpp/ascendc_kernel_cmake && export ASCEND_INSTALL_PATH=/home/developer/Ascend/cann && cd /mnt/workspace/gitCode/qiang_zq/runtime/example/3_memory_advanced/allocator/0_custom_allocator && rm -rf build && dos2unix run.sh 2>/dev/null \|\| sed -i 's/\\r$//' run.sh && bash run.sh Configuring CMake... -- The C compiler identification is GNU 13.3.0 -- The CXX compiler identification is GNU 13.3.0 -- Detecting C compiler ABI info -- Detecting C compiler ABI info - done -- Check for working C compiler: /usr/bin/cc - skipped -- Detecting C compile features -- Detecting C compile features - done -- Detecting CXX compiler ABI info -- Detecting CXX compiler ABI info - done -- Check for working CXX compiler: /usr/bin/c++ - skipped -- Detecting CXX compile features -- Detecting CXX compile features - done -- Configuring done -- Generating done -- Build files have been written to: /mnt/workspace/gitCode/qiang_zq/runtime/example/3_memory_advanced/allocator/0_custom_allocator/build Building... [ 50%] Building CXX object CMakeFiles/main.dir/main.cpp.o [100%] Linking CXX executable main [100%] Built target main Build completed successfully! Executable location: /mnt/workspace/gitCode/qiang_zq/runtime/example/3_memory_advanced/allocator/0_custom_allocator/build/main Run the sample: ./build/main ./build/main [INFO] CustomAlloc size=256 [INFO] CustomAllocAdvise size=128 [INFO] CustomAlloc size=128 [INFO] CustomFree invoked [INFO] CustomFree invoked [INFO] Allocator desc queried: descOut=0xaaaabd6a3780 allocCount=2 freeCount=2 用例执行报告 0_quickstart (3/3) ✅ ✅ 0_hello_cann ✅ 1_error_handling ✅ 2_system_info 1_basic_features (23/23) ✅ ✅ device/0_device_normal ✅ device/1_device_multi_thread ✅ device/2_device_P2P ✅ event/0_event_status ✅ event/1_event_timestamp ✅ memory/0_h2h_memory_copy ✅ memory/10_ipc_memory_withpid ✅ memory/11_ipc_memory_withoutpid ✅ memory/1_h2d_sync_memory_copy ✅ memory/2_h2d_async_memory_copy ✅ memory/3_d2h_sync_memory_copy ✅ memory/4_d2h_async_memory_copy ✅ memory/5_d2d_sync_memory_copy ✅ memory/6_d2d_async_memory_copy ✅ memory/7_physical_memory_sharing_withpid ✅ memory/8_physical_memory_sharing_withoutpid ✅ memory/9_multistream_sync_memory ✅ stream/0_simple_stream ✅ stream/1_stream_with_failure_mode ✅ stream/2_multi_stream 2_advanced_features (17/17) ✅ ✅ built_in_task/0_reduce_task ✅ built_in_task/1_random_num_task ✅ callback/0_simple_callback ✅ callback/1_callback_hostfunc ✅ callback/2_callback_exception ✅ group/0_compute_group ✅ kernel/0_launch_kernel ✅ kernel/1_launch_kernel_with_reslimit ✅ label/0_simple_label ✅ model_ri/0_simple_model ✅ model_ri/1_model_update ✅ model_ri/2_model_switch ✅ notify/0_ipc_notify_withpid ✅ notify/1_ipc_notify_withoutpid ✅ notify/2_cntnotify ✅ tdt_buffer/0_shared_buffer ✅ tdt_channel/0_simple_channel ✅ tdt_channel/1_channel_capacity ✅ tdt_queue/0_simple_queue ✅ tdt_queue/1_queue_route ✅ tdt_queue/2_queue_grant_attach 3_memory_advanced (1/1) ✅ ✅ allocator/0_custom_allocator 4_reliability (2/2) ✅ ✅ overflow_detection/0_overflow_detection ✅ snapshot/0_snapshot_management 5_performance (6/6) ✅ ✅ adump/0_adump_args ✅ adump/1_adump_callback ✅ adump/2_model_dump_config ✅ profiling/0_create_config ✅ profiling/1_msproftx ✅ profiling/2_subscribe_model ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> docs/02_dev_guide/初始化.md example/*.md ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/runtime!1163	3 months ago

样例使用指导

example目录下提供了一系列Runtime接口样例，包括Device管理、Stream管理、Event管理、内存管理、Kernel执行等，供开发者参考，帮助开发者快速入门，进而掌握Runtime关键特性。

目录总览

0_quickstart：快速入门样例，以 aclnnAdd 向量加法为入口，展示初始化配置、Device/Stream 创建、Tensor 与 DataBuffer 管理、workspace 分配、算子执行、同步等待和资源释放流程。
1_basic_features：基础特性样例，包含设备管理（包括单线程、多线程）、内存管理（包括内存复制、进程间内存共享、虚拟内存管理等）、Stream管理（包括单流任务下发、多流任务下发等）等样例。
2_advanced_features：高级特性样例，包括算子Kernel加载与执行、ACL Graph、Reduce和随机数生成的内置系统任务执行、Host侧回调函数下发等样例。
3_memory_advanced：高级内存管理样例，包括自定义内存分配器、Host内存注册、统一寻址、Stream内存操作、Stream有序内存分配等样例。
4_reliability：可靠性样例，包括溢出检测、错误恢复等样例。
5_performance：性能分析与精度调试样例。
6_scenarios：场景化样例，面向训练流水线、多设备推理和容错执行等典型场景。

产品支持表说明

各样例 README 中的产品支持表仅列出当前样例已完成验证或已明确声明支持情况的产品。Ascend 950PR/Ascend 950DT 为新增产品，部分历史样例尚未完成该产品验证；未在表格中列出的产品不代表不支持。若某产品明确不支持，样例 README 会在表格中以 × 标识，并根据需要补充说明。

环境准备

编译运行样例前，需获取固件、驱动及CANN软件包并安装，详细步骤请参见《CANN软件安装指南》。

若对本仓src目录下的源码有定制，那么在安装CANN软件之后，还需编译源码并部署到环境上，具体操作请参见README。

运行样例

1.下载样例代码并上传至安装CANN软件的环境，切换到样例目录。

# 此处以基础内存样例为例
cd ${git_clone_path}/example/1_basic_features/memory/0_h2h_memory_copy

2.设置环境变量。

# ${install_root} 替换为 CANN 安装根目录，默认安装在`/usr/local/Ascend`目录
source ${install_root}/cann/set_env.sh
export ASCEND_INSTALL_PATH=${install_root}/cann

3.执行以下命令运行样例。

# 请注意部分用例的运行命令不同，具体以各用例目录下的README.md中的编译运行命令为准
bash run.sh

样例代码说明

所有样例演示了CANN Runtime API 的典型使用方式。

样例代码用于学习和接口理解。
为了突出核心流程，部分示例会简化工程化处理。
用于生产环境前，请补充完整的错误处理、资源管理和边界检查。

Device 复位接口使用约定

单机单进程样例通常使用 aclrtResetDeviceForce 清理当前样例占用的 Device 资源；单机多进程 IPC 样例使用 aclrtResetDevice 释放当前进程的 Device 资源，避免强制复位影响同机其他进程。