Star556

Star556

cann-robot【PR】: fix support list of snapshot interfaces

30144fee创建于 18 天前历史提交

文件	最后提交记录	最后更新时间
01_quick_start	【PR】: fix:address documentation review issues Co-authored-by: Liu Peiling<1245275864@qq.com> # message auto-generated for no-merge-commit merge: !2738 merge lpl_fix_docs into master 【PR】: fix:address documentation review issues Created-by: freedom178 Commit-by: Liu Peiling Merged-by: cann-robot Description: # Pull Request ## 描述修复文档审查报告中扫描出来的docs问题，解决了issue中提到的“*”渲染问题 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [ ] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x ] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试描述测试此变更的步骤和前提条件： 1. 2. ## 核对清单 <!-- [x] 表示选中 --> - [ ] 我的代码遵循了项目的代码风格 - [ ] 我已对代码进行了自测 - [ ] 我已更新了相关的文档 - [ ] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [ ] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!2738	2 个月前
02_dev_guide	fix: RT_ERROR_STREAM_UNJOINED 错误码整改及文档更新 Co-authored-by: yanmingxiang<yanmingxiang@huawei.com> # message auto-generated for no-merge-commit merge: !3916 merge fix/stream-unjoined-errmsg-9.1.0 into 9.1.0 fix: RT_ERROR_STREAM_UNJOINED 错误码整改及文档更新 Created-by: yanmingxiang Commit-by: yanmingxiang Merged-by: cann-robot Description: --- title: "fix: RT_ERROR_STREAM_UNJOINED 错误码整改及文档更新" labels: ["enhancement"] --- # Pull Request ## 描述将 PR #3846 同步到 9.1.0 分支。对 `RT_ERROR_STREAM_UNJOINED`（0x0703001F / ACL_ERROR_RT_STREAM_UNJOINED 107025）的 6 个调用点进行 Error Message 整改，并将相关文档术语对齐。主要变更： - #1（`context_aclgraph.cc`，streams 为空）为内部错误，不修改 - #2-#6 共 5 个站点从纯 RT_LOG / EE9999 改为 `COND_RETURN_AND_MSG_OUTER` + EE1017（Invalid_Argument），param 为 `"capture model"` - #4 新增 `origStreamId` 变量保存主流 id - `errcode_manage.cc`：`original stream` 改为 `origin stream` - v100/v200 新增 `#include "error_message_manage.hpp"` - reason 文案改为英文，包含定位信息和修复指引 - 跨流捕获开发指南术语对齐（主流/子流） ## 变更类型 - [x] 🐛 Bug 修复（Error Message 上报不正确） - [x] 📝 文档内容更新 ## 关联的Issue ## 如何测试 1. 编译验证通过 2. UT 验证：`runtime_utest_api_david` capture 相关 7 tests PASSED ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定 See merge request: cann/runtime!3916	18 天前
03_api_ref	【PR】: fix support list of snapshot interfaces Co-authored-by: zhongliang<zhongliang2@huawei.com> # message auto-generated for no-merge-commit merge: !3951 merge 9.1.0 into 9.1.0 【PR】: fix support list of snapshot interfaces Created-by: zhongliangtx Commit-by: zhongliang Merged-by: cann-robot Description: # Pull Request ## 描述请清晰准确地描述本次 Pull Request 的意图和变更内容。 snapshot接口当前在950DT暂不支持。 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [x] 📝 文档内容更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在当前页面的右侧'关联Issue'部分添加相应Issue链接，并勾选'合并后关闭已关联的 Issue'选项。 --> ## 如何测试描述测试此变更的步骤和前提条件： 1.文档修改。 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [x] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!3951	18 天前
04_FAQ	docs: 新增常见FAQ Co-authored-by: good_luck_to_me<qiaoruimin@huawei.com> # message auto-generated for no-merge-commit merge: !2806 merge doc/faq-clean into master docs: 新增常见FAQ Created-by: good_luck_to_me Commit-by: good_luck_to_me Merged-by: cann-robot Description: # Pull Request ## 描述新增16篇 Runtime FAQ 文档，覆盖常见错误码解读、内存分配、流管理、设备调用、ACLGraph 等场景。替换4篇旧FAQ文档，并更新 docs/README.md 导航表。 ## 变更类型 - [x] 📝 文档内容更新 ## 关联的Issue ## 如何测试 1. 检查 docs/04_FAQ/ 下16篇新文档内容 2. 检查 docs/README.md FAQ导航表链接正确 3. 确认旧FAQ文件已删除 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签 - [x] 我已经详细阅读了贡献指南 ## 其他信息原 PR #2623 因分支混乱重建。 See merge request: cann/runtime!2806	2 个月前
design	【PR】: aclGraph optimize Co-authored-by: 侯延保<houyanbao@huawei.com> # message auto-generated for no-merge-commit merge: !3457 merge C910_1 into 9.1.0 【PR】: aclGraph optimize Created-by: houyanbao Commit-by: 侯延保 Merged-by: cann-robot Description: # Pull Request ## 描述 1、优化model sequenceid的分配逻辑，在添加task的地方统一分配，避免流程出现遗留 2、aclGraph模型执行时，当notify资源不足时，当前只释放了notifyid，没有释放sqcq，这会导致被释放的模型，下次再次执行时，没有更新notifyid，为简化流程，提升代码可读性，模型资源释放时，sqcq和notify整体释放 ## 变更类型请选择本次引入的变更类型： <!-- [x] 表示选中 --> - [x] 🐛 Bug 修复 - [ ] ✨ 新功能 - [ ] 💄 代码风格更新（格式化，局部变量） - [ ] ♻️ 重构（既不修复错误也不增加功能的代码变动） - [ ] 📦 构建过程或辅助工具的变动 - [ ] 📝 文档内容更新 ## 关联的Issue NA ## 如何测试描述测试此变更的步骤和前提条件： 1. 验证SK功能 2.验证aclGraph notify资源不足，触发模型资源回收流程 ## 核对清单 <!-- [x] 表示选中 --> - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [ ] 我已更新了相关的文档 - [ ] 我在标题中使用了合适的类型标签（如：`feat:`, `fix:`） - [ ] 我已经详细阅读了贡献指南（CONTRIBUTING.md），并遵守了其中的所有规定，包括但不限于commit message的格式、无效commit的合并等 ## 其他信息在此添加任何其他关于本次 PR 的说明。 See merge request: cann/runtime!3457	1 个月前
guidelines	docs: 重命名guidelines文件为英文并集成到README Co-authored-by: wangtao43<wangtao43@huawei.com> # message auto-generated for no-merge-commit merge: !2734 merge docs/rename-guidelines-files-to-english into master docs: 重命名guidelines文件为英文并集成到README Created-by: wangtao43 Commit-by: wangtao43 Merged-by: cann-robot Description: # Pull Request ## 描述本次 PR 将 guidelines 目录下的中文文件名改为英文，并集成到 docs/README.md 的文档导航中。 ## 变更类型 - [x] 📝 文档内容更新 ## 关联的Issue 无 ## 如何测试 1. 查看 docs/guidelines/dt_guide/ 目录，确认文件名已改为英文 2. 查看 docs/README.md 文档导航表格，确认新增"研发规范"章节 3. 点击链接，确认可以正常访问 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签（docs:） - [x] 我已经详细阅读了贡献指南，并遵守了其中的所有规定 ## 其他信息 - 文件重命名：测试框架指南.md → test_framework_guide.md - 文件重命名：UT用例开发指导.md → ut_case_development_guide.md - 更新链接引用：docs/guidelines/dt_guide/README.md - 新增导航章节：docs/README.md 增加"研发规范"行此改进符合国际化要求，方便海外贡献者访问文档。 See merge request: cann/runtime!2734	2 个月前
.gitignore	Initial commit	7 个月前
README.md	docs: 新增常见FAQ Co-authored-by: good_luck_to_me<qiaoruimin@huawei.com> # message auto-generated for no-merge-commit merge: !2806 merge doc/faq-clean into master docs: 新增常见FAQ Created-by: good_luck_to_me Commit-by: good_luck_to_me Merged-by: cann-robot Description: # Pull Request ## 描述新增16篇 Runtime FAQ 文档，覆盖常见错误码解读、内存分配、流管理、设备调用、ACLGraph 等场景。替换4篇旧FAQ文档，并更新 docs/README.md 导航表。 ## 变更类型 - [x] 📝 文档内容更新 ## 关联的Issue ## 如何测试 1. 检查 docs/04_FAQ/ 下16篇新文档内容 2. 检查 docs/README.md FAQ导航表链接正确 3. 确认旧FAQ文件已删除 ## 核对清单 - [x] 我的代码遵循了项目的代码风格 - [x] 我已对代码进行了自测 - [x] 我已更新了相关的文档 - [x] 我在标题中使用了合适的类型标签 - [x] 我已经详细阅读了贡献指南 ## 其他信息原 PR #2623 因分支混乱重建。 See merge request: cann/runtime!2806	2 个月前

CANN Runtime

昇腾 AI 处理器轻量级运行时环境 · 端云一致 · 高性能推理
CANN Runtime 是昇腾 AI 处理器的核心运行时底座，它通过提供统一的 API，使得上层应用、AI 框架、加速库能够高效利用 AI 处理器的硬件计算资源。

📚 文档导航

文档	定位与内容	入口
⚡ 快速入门	零基础起步，第一次接触 Runtime 的开发者。Runtime 简介 + 编程模型讲解，建议顺序阅读	Runtime 简介 · 编程模型
📖 编程指南	深度开发手册，已跑通入门阶段 Hello CANN 后需要深入理解原理的开发者。原理解析 + 示例代码	编程指南
📋 API 参考	接口字典，开发过程中随时查阅函数定义。函数签名 + 参数说明 + 返回值	头文件说明 · API 参考
🏗️ 架构指南	面向贡献者的架构文档。Runtime 整体架构、模块设计、核心组件解析	架构指南
📝 研发规范	面向贡献者的规范指南，包括设计文档模板、编码规范、测试规范、代码检视规则	研发规范与贡献指南

🗺️ 成长地图

按以下路径循序渐进，从环境准备到独立开发：

🌱 入门阶段

学习步骤	内容说明	入口
环境准备	CANN 一键安装	CANN 一键安装
概念原理	Runtime 核心概念与编程模型：Host-Device 架构、Context、Stream、同步异步、典型执行流程	Runtime 简介 · 编程模型
Hello CANN	第一个可运行的 Runtime 程序，完成最小计算闭环	Hello CANN

🚀 进阶阶段

主题	核心内容	对应样例
初始化	包括环境初始化、设备资源配置、日志管理等	device_normal
内存管理	包括 Host 内存管理、Device 内存管理、多流同步内存、内存拷贝（同步异步）、物理内存共享 (pid) 等	h2d_sync_memory_copy
异步任务	包括 Stream 管理、Event 管理、Kernel 加载与执行、内存语义同步等	simple_stream

🔥 高级阶段

主题	核心内容	对应样例
ACL Graph	包括单流捕获、跨流捕获、任务更新等	model_update
多设备编程	包括跨 Device 数据交互、P2P 内存访问、多卡并行调度等	device_P2P
进程间通信	包括 IPC Event 同步、IPC 内存共享（指定 PID/不指定 PID）等	ipc_event · ipc_memory
性能调优	包括 Profiling 采集并落盘、获取网络模型中算子的性能数据、可视化展示原始性能数据解析结果等	create_config

❓ 常见问题

问题类型	典型场景	入口
入门阶段	初始化失败、Device 配置、版本兼容等入门常见问题	版本不匹配 · aclInit 失败 · aclrtSetDevice 失败 · 默认机制
基础开发	内存管理、Stream 同步、数据复制等基础 API 使用问题	内存申请失败 · Stream 下发失败 · 内存策略 · 同步机制
进阶场景	多设备编程、ACL Graph、进程通信等复杂场景问题	多Device Stream · ACL Graph 任务提交 · IPC 页表对齐 · P2P 配置失败
错误排查	错误码解读、算子异常、日志定位等诊断方法	异步错误码 · 算子输出异常 · 遇错即停定位 · plog 日志定位

相关资源
昇腾社区 · Runtime 样例仓库 · 完整文档中心

_{CANN Runtime 文档 | 华为昇腾}