| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
更新c api原子操作文档 Co-authored-by: GRJ_XIDUO<guorenjie3@huawei.com> # message auto-generated for no-merge-commit merge: !5659 merge 2026_09_01_modify_c_api_simd_atomic_docs into master 更新c api原子操作文档 Created-by: GRJ_XIDUO Commit-by: g00954335;GRJ_XIDUO Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 当前仓include目录中C API头文件已整改，Atomic接口文档中的调用示例仍使用 c_api/asc_simd.h，与本项目实际头文件入口不一致。 本次将Scalar Atomic调用示例改为按需包含c_api/atomic/scalar_atomic.h、c_api/cache_ctrl/cache_ctrl.h、c_api/sync/sync.h和c_api/utils/sys_init.h；将DataMove Atomic调用示例改为包含c_api/atomic/datamove_atomic.h、c_api/sync/sync.h、c_api/utils/sys_init.h和c_api/vector_datamove/vector_datamove.h。 同时在各Atomic接口文档“功能说明”首句补充头文件路径说明，并与后续功能描述换行分隔，使文档说明和调用示例均以本项目include目录为准。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 无 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> Examples: 3 [PASS] asc_set_atomic_add exit=0 [PASS] asc_set_atomic_max exit=0 [PASS] asc_set_atomic_min exit=0 Total: 3, Passed: 3, Failed: 0 Examples: 13 [PASS] asc_atomic_add exit=0 [PASS] asc_atomic_and exit=0 [PASS] asc_atomic_cas exit=0 [PASS] asc_atomic_dec exit=0 [PASS] asc_atomic_exch exit=0 [PASS] asc_atomic_inc exit=0 [PASS] asc_atomic_max exit=0 [PASS] asc_atomic_min exit=0 [PASS] asc_atomic_or exit=0 [PASS] asc_atomic_sub exit=0 [PASS] asc_atomic_xor exit=0 [FAIL] asc_get_store_atomic_config exit=1 [FAIL] asc_set_store_atomic_config_v1 exit=1 Total: 13, Passed: 11, Failed: 2（950产品不支持，因此失败是符合预期的，后续在2201架构产品上测试通过） ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新docs/zh/api/SIMD-API/c_api/atomic下Atomic接口文档的头文件说明和调用示例头文件引用。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5659 | 30 天前 | |
完善C API缓存控制、系统变量访问接口资料 Co-authored-by: GRJ_XIDUO<guorenjie3@huawei.com> # message auto-generated for no-merge-commit merge: !5697 merge 2026_09_02_modify_c_api_cache_ctrl_docs into master 完善C API缓存控制、系统变量访问接口资料 Created-by: GRJ_XIDUO Commit-by: g00954335;GRJ_XIDUO Merged-by: cann-robot Description: ## 描述 完善C API缓存控制接口的调用示例，补充DataCache预取、DCI/DCCI、ICache预取及标量L2 Cache策略的完整示例和关联状态查询说明。 同步更新系统缓存概览、系统变量及相关缓存一致性文档，使接口说明与当前实现保持一致。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 调用示例分别在不同的产品上进行测试。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5697 | 30 天前 | |
C API系统变量接口资料修改 Co-authored-by: qwerwjy<wangjunyi23@huawei.com> # message auto-generated for no-merge-commit merge: !5620 merge master into master C API系统变量接口资料修改 Created-by: qwerwjy Commit-by: qwerwjy Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 完善C API的系统变量接口部分文档，包括以下内容： 1.完善功能说明和参数说明，针对关键部分进行详细介绍。 2.修改函数原型部分，将其改为模板原型形式。 3.补充约束内容，明确使用场景。 4.重写调用示例，将其改为可以一键编译运行的形式。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新了docs/zh/api/SIMD-API/c_api目录下的部分文档 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5620 | 27 天前 | |
Update description for quant param in L0C: does not support inf / nan value Co-authored-by: chentianyu19<chentianyu19@huawei.com> # message auto-generated for no-merge-commit merge: !5868 merge 0910_fix_quant_inf into master Update description for quant param in L0C: does not support inf / nan value Created-by: chentianyu19 Commit-by: chentianyu19 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 文档添加说明：L0C相关量化参数不支持设置为inf / nan。芯片涉及310P、910B 、950。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5868 | 26 天前 | |
C API新增和修改矩阵相关资料 Co-authored-by: UFOunder<zhangxiru1@huawei.com> # message auto-generated for no-merge-commit merge: !5711 merge master into master C API新增和修改矩阵相关资料 Created-by: UFOunder Commit-by: UFOunder Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> C API新增和修改矩阵相关资料 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5711 | 29 天前 | |
vector搬运类全量接口 Co-authored-by: chenmyk<chenmingyu16@huawei.com> # message auto-generated for no-merge-commit merge: !5322 merge full_set into master vector搬运类全量接口 Created-by: chenmyk Commit-by: chenmyk Merged-by: cann-robot Description: ## 描述 deprecated废弃接口 docs\zh\api\SIMD-API\c_api\deprecated_interface\deprecated_interface.md docs\zh\api\appendix\deprecated_interface.md docs\zh\api\SIMD-API\c_api\c_api.md 以及对应废弃接口文档更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5322 | 26 天前 | |
接口文档中添加头文件路径说明 Co-authored-by: JC1126<jiangchao69@h-partners.com> # message auto-generated for no-merge-commit merge: !5633 merge jc_0904 into master 接口文档中添加头文件路径说明 Created-by: JC1126 Commit-by: JC1126 Merged-by: cann-robot Description: ## 描述 接口文档中添加头文件路径说明 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5633 | 1 个月前 | |
vector搬运类全量接口 Co-authored-by: chenmyk<chenmingyu16@huawei.com> # message auto-generated for no-merge-commit merge: !5322 merge full_set into master vector搬运类全量接口 Created-by: chenmyk Commit-by: chenmyk Merged-by: cann-robot Description: ## 描述 deprecated废弃接口 docs\zh\api\SIMD-API\c_api\deprecated_interface\deprecated_interface.md docs\zh\api\appendix\deprecated_interface.md docs\zh\api\SIMD-API\c_api\c_api.md 以及对应废弃接口文档更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5322 | 26 天前 | |
docs:完善duplicate接口文档 Co-authored-by: Joey_guo<guojianyang@huawei.com> # message auto-generated for no-merge-commit merge: !5858 merge dup into master docs:完善duplicate接口文档 Created-by: Joey_guo Commit-by: Joey_guo Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5858 | 27 天前 | |
C API系统变量接口资料修改 Co-authored-by: qwerwjy<wangjunyi23@huawei.com> # message auto-generated for no-merge-commit merge: !5620 merge master into master C API系统变量接口资料修改 Created-by: qwerwjy Commit-by: qwerwjy Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 完善C API的系统变量接口部分文档，包括以下内容： 1.完善功能说明和参数说明，针对关键部分进行详细介绍。 2.修改函数原型部分，将其改为模板原型形式。 3.补充约束内容，明确使用场景。 4.重写调用示例，将其改为可以一键编译运行的形式。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新了docs/zh/api/SIMD-API/c_api目录下的部分文档 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5620 | 27 天前 | |
C API系统变量接口资料修改 Co-authored-by: qwerwjy<wangjunyi23@huawei.com> # message auto-generated for no-merge-commit merge: !5620 merge master into master C API系统变量接口资料修改 Created-by: qwerwjy Commit-by: qwerwjy Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 完善C API的系统变量接口部分文档，包括以下内容： 1.完善功能说明和参数说明，针对关键部分进行详细介绍。 2.修改函数原型部分，将其改为模板原型形式。 3.补充约束内容，明确使用场景。 4.重写调用示例，将其改为可以一键编译运行的形式。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新了docs/zh/api/SIMD-API/c_api目录下的部分文档 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5620 | 27 天前 | |
补充C API核间同步关键特性说明 Co-authored-by: g00954335<guorenjie3@huawei.com> # message auto-generated for no-merge-commit merge: !5864 merge 2026_09_09_add_c_api_inter_core_sync_key_feature into master 补充C API核间同步关键特性说明 Created-by: GRJ_XIDUO Commit-by: g00954335;GRJ_XIDUO Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 补充C API核间同步关键特性文档，通过代码片段和时序图说明模式0、模式1、模式2及模式4的执行原理。 完善各核间同步接口文档与概述页之间的跳转关系，并补充函数执行空间限定符相关约束。 区分不同NPU架构下 wait接口的流水阻塞行为：2201架构忽略pipe参数并阻塞全部流水，3510架构阻塞pipe参数指定的流水。同时修正模式0、模式1和模式2示例中的wait流水参 数及相关说明。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5864 | 27 天前 | |
C API系统变量接口资料修改 Co-authored-by: qwerwjy<wangjunyi23@huawei.com> # message auto-generated for no-merge-commit merge: !5620 merge master into master C API系统变量接口资料修改 Created-by: qwerwjy Commit-by: qwerwjy Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 完善C API的系统变量接口部分文档，包括以下内容： 1.完善功能说明和参数说明，针对关键部分进行详细介绍。 2.修改函数原型部分，将其改为模板原型形式。 3.补充约束内容，明确使用场景。 4.重写调用示例，将其改为可以一键编译运行的形式。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新了docs/zh/api/SIMD-API/c_api目录下的部分文档 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5620 | 27 天前 | |
C API系统变量接口资料修改 Co-authored-by: qwerwjy<wangjunyi23@huawei.com> # message auto-generated for no-merge-commit merge: !5620 merge master into master C API系统变量接口资料修改 Created-by: qwerwjy Commit-by: qwerwjy Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 完善C API的系统变量接口部分文档，包括以下内容： 1.完善功能说明和参数说明，针对关键部分进行详细介绍。 2.修改函数原型部分，将其改为模板原型形式。 3.补充约束内容，明确使用场景。 4.重写调用示例，将其改为可以一键编译运行的形式。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新了docs/zh/api/SIMD-API/c_api目录下的部分文档 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5620 | 27 天前 | |
vector搬运类全量接口 Co-authored-by: chenmyk<chenmingyu16@huawei.com> # message auto-generated for no-merge-commit merge: !5322 merge full_set into master vector搬运类全量接口 Created-by: chenmyk Commit-by: chenmyk Merged-by: cann-robot Description: ## 描述 deprecated废弃接口 docs\zh\api\SIMD-API\c_api\deprecated_interface\deprecated_interface.md docs\zh\api\appendix\deprecated_interface.md docs\zh\api\SIMD-API\c_api\c_api.md 以及对应废弃接口文档更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5322 | 26 天前 | |
优化CAPI资料目录 Co-authored-by: JC1126<jiangchao69@h-partners.com> # message auto-generated for no-merge-commit merge: !5336 merge jc_0824 into master 优化CAPI资料目录 Created-by: JC1126 Commit-by: JC1126 Merged-by: cann-robot Description: ## 描述 优化CAPI资料目录 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5336 | 1 个月前 | |
vector搬运类全量接口 Co-authored-by: chenmyk<chenmingyu16@huawei.com> # message auto-generated for no-merge-commit merge: !5322 merge full_set into master vector搬运类全量接口 Created-by: chenmyk Commit-by: chenmyk Merged-by: cann-robot Description: ## 描述 deprecated废弃接口 docs\zh\api\SIMD-API\c_api\deprecated_interface\deprecated_interface.md docs\zh\api\appendix\deprecated_interface.md docs\zh\api\SIMD-API\c_api\c_api.md 以及对应废弃接口文档更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5322 | 26 天前 | |
fix:统一capi中有关dtype的称呼 Co-authored-by: haipingmao<maohaiping@huawei.com> # message auto-generated for no-merge-commit merge: !5276 merge br_fix_docs into master fix:统一capi中有关dtype的称呼 Created-by: haipingmao Commit-by: haipingmao Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 背景： - 当前CAPI/reg_compute目录下，有关dtype的描述并不统一，既有加粗、也有将 dtype支持数据类型作为三级标题。 - 数组方式申请地址不仅在A2/A3上支持，也在A5上支持。 修改点： - 统一这类称呼，将dtype支持数据类型作为三级标题或者四级标题，将内容均用高亮表示。 - 删除有关数组申请的错误描述，现在不仅支持A2，还支持A5。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> COMPILE ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> CAPI/reg_compute目录下某些.md文档 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5276 | 1 个月前 |
C API
C API开放芯片完备编程能力，支持以数组形式分配内存，一般基于指针编程。提供与业界一致的C语言编程体验。
定位与特性
C API是Ascend C三层梯度化编程接口中的语言扩展层SIMD API，定位为最底层的C语言接口，基于指针编程，提供完备的C语言编程能力。C API可直接映射NPU硬件指令，开发者自主管理内存搬运与同步（与TPipe/TQue自动管理内存、同步不同），开放全部底层硬件能力。适配C语言开发习惯，适合对性能和可控性要求较高的算子开发场景，是追求极致性能、充分释放NPU硬件潜能的核心路径。
详细内容请参考C语言编程概述。
需要包含的头文件
说明
包含asc_simd.h文件来调用C API相应接口。如无特殊说明，包含该头文件即可满足接口调用需求。 若API文档中有特殊说明，则应遵循API的具体说明。
#include "c_api/asc_simd.h"
API类型介绍
- 前n个数据计算：该类型API在计算时采用“紧密排布”的数据读取方式，即从起始位置开始，按顺序连续获取所需数据。例如，若需处理N个数据，则从源操作数的第0个位置开始，依次取至第N-1个位置。
- 高维切分计算：该类型API按照设定的规则“跳过部分数据”。适合处理需要间隔采样的场景，灵活度高，但需要额外配置相关参数。
- 同步计算：该类型API内部自动插入同步操作，易用性更强。
关键字
表1 关键字列表
| 名称 | 描述 |
|---|---|
| __gm__ | 存储空间定义修饰符，表示被修饰的变量位于Global Memory地址空间。 |
| __ubuf__ | 存储空间定义修饰符，表示被修饰的变量位于UB地址空间。 |
| __aicore__ | 执行空间限定符。表示该函数只能在Ai Core上执行。 |
| __cbuf__ | 存储空间定义修饰符，表示被修饰的变量位于L1 Buffer地址空间。 |
| __simd_callee__ | 执行空间限定符。表示该函数只能在Reg上执行。 |
流水类型
NPU内部有不同的计算单元，在计算时往往需要把计算数据搬运到计算单元上。不同计算单元上的计算过程、数据搬运过程可划分为不同的流水线。在AI Core上执行的操作会被分配到不同的流水线(PIPE)上执行，包括以下几种：
- PIPE_S：标量流水线，负责指令分发和标量计算。
- PIPE_V：矢量计算流水线。
- PIPE_M：矩阵计算流水线。
- PIPE_MTE1：搬运操作。包括从L1 Buffer到L0A Buffer或L0B Buffer，从L1 Buffer到Unified Buffer（UB）的搬运操作和L0A Buffer或L0B Buffer的初始化操作。
- PIPE_MTE2：搬运操作。包括从GM到L1 Buffer、从GM到L0A Buffer或L0B Buffer、从GM到UB的搬运操作和L1 Buffer的初始化操作。
- PIPE_MTE3：搬运操作。包括从UB到GM、从UB到L1 Buffer、从L1 Buffer到GM的操作和从UB到UB的搬运操作。
- PIPE_FIX：Fixpipe流水线。
- PIPE_ALL：所有流水线。
可通过同步控制类API控制同一流水线内的运行顺序和不同流水线间的执行顺序。
API列表
| 目录 |
|---|
| 基础定义 |
| 工具接口 |
| 矩阵计算 |
| 矩阵计算搬运 |
| Memory矢量计算 |
| 矢量数据搬运 |
| Reg矢量计算 |
| 标量计算 |
| 原子操作 |
| 缓存控制 |
| 同步控制 |
| 其他操作 |
| 特殊寄存器访问 |
| 废弃接口 |
参考样例
Atlas A3 训练系列产品/Atlas A3 推理系列产品的C API样例请参考C API Add样例。 Ascend 950PR/Ascend 950DT的C API样例请参考C API Add样例。