| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
优化兼容性手册 Co-authored-by: zhuangjinjun<zhuangjinjun@huawei.com> # message auto-generated for no-merge-commit merge: !5577 merge opt-example into master 优化兼容性手册 Created-by: printfscanfmain Commit-by: zhuangjinjun Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次改动围绕2201到3510架构基础API迁移指导文档及其配套兼容性样例进行全面完善，主要包括以下方面： 1. **迁移指导文档完善**（ basic_api_migration.md）：重写并扩充迁移指导内容，新增Fixpipe参数结构体切换（NZ2ND/NZ2NZ场景）、GM→L0A/L0B通路拆分、L0A/L0B Buffer初始化适配等章节；将样例代码位置信息从独立段落转移到代码块注释中（改为"参考样例代码行"格式）；补充末尾句号；将锚点从 <a name> 统一改为 <a id>；新增图5/图6说明L0A Buffer复用场景的分形适配。 2. **新增样例**：新增 subnormal 和 fixpipe_params_switch 两个完整兼容性样例（含CMakeLists.txt、README、scripts、.asc、data_utils.h）。 3. **样例错误处理加固**：对全部7个样例的 main() 函数进行加固——用 CHECK_ACL 宏包装所有ACL调用（aclInit/aclrtSetDevice/aclrtMalloc/aclrtMemcpy等），指针声明初始化为 nullptr，检查 ReadFile/WriteFile 返回值并在失败时打印 ERROR_LOG 并 return -1；在5个样例的 data_utils.h 中补充 CHECK_ACL 宏定义。 4. **样例接口更新**：将 set_loaddata_boundary 中的 DivCeil 替换为 AscendC::Std::ceil_div，与其它样例统一使用最新工具接口；将 SetLoadDataRepeat/SetLoadDataRepeatWithStride 的聚合初始化改为显式结构体成员赋值；完善 pattern_transformation 中3510分支的L1→L0B搬运逻辑（新增 LoadData2DParamsV2 路径）。 5. **README更新**：更新 pattern_transformation 的中英文README，补充完整的代码示例；更新兼容性样例总README索引。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 无 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。-->  | 样例 | NPU | CPU | |------|-----|-----| | subnormal | test pass! | test pass! | | data_copy_l1togm | test pass! | test pass! | | set_loaddata_boundary | test pass! | test pass! | | matmul_s4 | test pass! | test pass! | | pattern_transformation | test pass! | test pass! | | fill | test pass! | test pass! | | fixpipe_params_switch | test pass! | test pass! | 编译架构：dav-3510，验证脚本输出 test pass! 确认精度通过。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - docs/zh/guide/cross_gen_migration_guide/3510_arch_migration/2201_to_3510_guide/basic_api_migration.md：全面重写迁移指导，扩充章节内容，优化代码示例展示格式 - docs/zh/guide/figures/fig_5_zn.png、fig_6_zn.png：新增L0A Buffer复用场景分形适配示意图 - examples/01_simd_cpp_api/06_compatibility_guide/subnormal/README.md、README_en.md：新增Subnormal兼容性样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/fixpipe_params_switch/README.md、README_en.md：新增Fixpipe参数结构体切换样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/pattern_transformation/README.md、README_en.md：更新代码示例 - examples/01_simd_cpp_api/06_compatibility_guide/README.md、README_en.md：更新样例索引 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5577 | 15 天前 | |
优化兼容性手册 Co-authored-by: zhuangjinjun<zhuangjinjun@huawei.com> # message auto-generated for no-merge-commit merge: !5577 merge opt-example into master 优化兼容性手册 Created-by: printfscanfmain Commit-by: zhuangjinjun Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次改动围绕2201到3510架构基础API迁移指导文档及其配套兼容性样例进行全面完善，主要包括以下方面： 1. **迁移指导文档完善**（ basic_api_migration.md）：重写并扩充迁移指导内容，新增Fixpipe参数结构体切换（NZ2ND/NZ2NZ场景）、GM→L0A/L0B通路拆分、L0A/L0B Buffer初始化适配等章节；将样例代码位置信息从独立段落转移到代码块注释中（改为"参考样例代码行"格式）；补充末尾句号；将锚点从 <a name> 统一改为 <a id>；新增图5/图6说明L0A Buffer复用场景的分形适配。 2. **新增样例**：新增 subnormal 和 fixpipe_params_switch 两个完整兼容性样例（含CMakeLists.txt、README、scripts、.asc、data_utils.h）。 3. **样例错误处理加固**：对全部7个样例的 main() 函数进行加固——用 CHECK_ACL 宏包装所有ACL调用（aclInit/aclrtSetDevice/aclrtMalloc/aclrtMemcpy等），指针声明初始化为 nullptr，检查 ReadFile/WriteFile 返回值并在失败时打印 ERROR_LOG 并 return -1；在5个样例的 data_utils.h 中补充 CHECK_ACL 宏定义。 4. **样例接口更新**：将 set_loaddata_boundary 中的 DivCeil 替换为 AscendC::Std::ceil_div，与其它样例统一使用最新工具接口；将 SetLoadDataRepeat/SetLoadDataRepeatWithStride 的聚合初始化改为显式结构体成员赋值；完善 pattern_transformation 中3510分支的L1→L0B搬运逻辑（新增 LoadData2DParamsV2 路径）。 5. **README更新**：更新 pattern_transformation 的中英文README，补充完整的代码示例；更新兼容性样例总README索引。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 无 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。-->  | 样例 | NPU | CPU | |------|-----|-----| | subnormal | test pass! | test pass! | | data_copy_l1togm | test pass! | test pass! | | set_loaddata_boundary | test pass! | test pass! | | matmul_s4 | test pass! | test pass! | | pattern_transformation | test pass! | test pass! | | fill | test pass! | test pass! | | fixpipe_params_switch | test pass! | test pass! | 编译架构：dav-3510，验证脚本输出 test pass! 确认精度通过。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - docs/zh/guide/cross_gen_migration_guide/3510_arch_migration/2201_to_3510_guide/basic_api_migration.md：全面重写迁移指导，扩充章节内容，优化代码示例展示格式 - docs/zh/guide/figures/fig_5_zn.png、fig_6_zn.png：新增L0A Buffer复用场景分形适配示意图 - examples/01_simd_cpp_api/06_compatibility_guide/subnormal/README.md、README_en.md：新增Subnormal兼容性样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/fixpipe_params_switch/README.md、README_en.md：新增Fixpipe参数结构体切换样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/pattern_transformation/README.md、README_en.md：更新代码示例 - examples/01_simd_cpp_api/06_compatibility_guide/README.md、README_en.md：更新样例索引 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5577 | 15 天前 | |
优化兼容性手册 Co-authored-by: zhuangjinjun<zhuangjinjun@huawei.com> # message auto-generated for no-merge-commit merge: !5577 merge opt-example into master 优化兼容性手册 Created-by: printfscanfmain Commit-by: zhuangjinjun Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次改动围绕2201到3510架构基础API迁移指导文档及其配套兼容性样例进行全面完善，主要包括以下方面： 1. **迁移指导文档完善**（ basic_api_migration.md）：重写并扩充迁移指导内容，新增Fixpipe参数结构体切换（NZ2ND/NZ2NZ场景）、GM→L0A/L0B通路拆分、L0A/L0B Buffer初始化适配等章节；将样例代码位置信息从独立段落转移到代码块注释中（改为"参考样例代码行"格式）；补充末尾句号；将锚点从 <a name> 统一改为 <a id>；新增图5/图6说明L0A Buffer复用场景的分形适配。 2. **新增样例**：新增 subnormal 和 fixpipe_params_switch 两个完整兼容性样例（含CMakeLists.txt、README、scripts、.asc、data_utils.h）。 3. **样例错误处理加固**：对全部7个样例的 main() 函数进行加固——用 CHECK_ACL 宏包装所有ACL调用（aclInit/aclrtSetDevice/aclrtMalloc/aclrtMemcpy等），指针声明初始化为 nullptr，检查 ReadFile/WriteFile 返回值并在失败时打印 ERROR_LOG 并 return -1；在5个样例的 data_utils.h 中补充 CHECK_ACL 宏定义。 4. **样例接口更新**：将 set_loaddata_boundary 中的 DivCeil 替换为 AscendC::Std::ceil_div，与其它样例统一使用最新工具接口；将 SetLoadDataRepeat/SetLoadDataRepeatWithStride 的聚合初始化改为显式结构体成员赋值；完善 pattern_transformation 中3510分支的L1→L0B搬运逻辑（新增 LoadData2DParamsV2 路径）。 5. **README更新**：更新 pattern_transformation 的中英文README，补充完整的代码示例；更新兼容性样例总README索引。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 无 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。-->  | 样例 | NPU | CPU | |------|-----|-----| | subnormal | test pass! | test pass! | | data_copy_l1togm | test pass! | test pass! | | set_loaddata_boundary | test pass! | test pass! | | matmul_s4 | test pass! | test pass! | | pattern_transformation | test pass! | test pass! | | fill | test pass! | test pass! | | fixpipe_params_switch | test pass! | test pass! | 编译架构：dav-3510，验证脚本输出 test pass! 确认精度通过。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - docs/zh/guide/cross_gen_migration_guide/3510_arch_migration/2201_to_3510_guide/basic_api_migration.md：全面重写迁移指导，扩充章节内容，优化代码示例展示格式 - docs/zh/guide/figures/fig_5_zn.png、fig_6_zn.png：新增L0A Buffer复用场景分形适配示意图 - examples/01_simd_cpp_api/06_compatibility_guide/subnormal/README.md、README_en.md：新增Subnormal兼容性样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/fixpipe_params_switch/README.md、README_en.md：新增Fixpipe参数结构体切换样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/pattern_transformation/README.md、README_en.md：更新代码示例 - examples/01_simd_cpp_api/06_compatibility_guide/README.md、README_en.md：更新样例索引 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5577 | 15 天前 | |
优化兼容性手册 Co-authored-by: zhuangjinjun<zhuangjinjun@huawei.com> # message auto-generated for no-merge-commit merge: !5577 merge opt-example into master 优化兼容性手册 Created-by: printfscanfmain Commit-by: zhuangjinjun Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次改动围绕2201到3510架构基础API迁移指导文档及其配套兼容性样例进行全面完善，主要包括以下方面： 1. **迁移指导文档完善**（ basic_api_migration.md）：重写并扩充迁移指导内容，新增Fixpipe参数结构体切换（NZ2ND/NZ2NZ场景）、GM→L0A/L0B通路拆分、L0A/L0B Buffer初始化适配等章节；将样例代码位置信息从独立段落转移到代码块注释中（改为"参考样例代码行"格式）；补充末尾句号；将锚点从 <a name> 统一改为 <a id>；新增图5/图6说明L0A Buffer复用场景的分形适配。 2. **新增样例**：新增 subnormal 和 fixpipe_params_switch 两个完整兼容性样例（含CMakeLists.txt、README、scripts、.asc、data_utils.h）。 3. **样例错误处理加固**：对全部7个样例的 main() 函数进行加固——用 CHECK_ACL 宏包装所有ACL调用（aclInit/aclrtSetDevice/aclrtMalloc/aclrtMemcpy等），指针声明初始化为 nullptr，检查 ReadFile/WriteFile 返回值并在失败时打印 ERROR_LOG 并 return -1；在5个样例的 data_utils.h 中补充 CHECK_ACL 宏定义。 4. **样例接口更新**：将 set_loaddata_boundary 中的 DivCeil 替换为 AscendC::Std::ceil_div，与其它样例统一使用最新工具接口；将 SetLoadDataRepeat/SetLoadDataRepeatWithStride 的聚合初始化改为显式结构体成员赋值；完善 pattern_transformation 中3510分支的L1→L0B搬运逻辑（新增 LoadData2DParamsV2 路径）。 5. **README更新**：更新 pattern_transformation 的中英文README，补充完整的代码示例；更新兼容性样例总README索引。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 无 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。-->  | 样例 | NPU | CPU | |------|-----|-----| | subnormal | test pass! | test pass! | | data_copy_l1togm | test pass! | test pass! | | set_loaddata_boundary | test pass! | test pass! | | matmul_s4 | test pass! | test pass! | | pattern_transformation | test pass! | test pass! | | fill | test pass! | test pass! | | fixpipe_params_switch | test pass! | test pass! | 编译架构：dav-3510，验证脚本输出 test pass! 确认精度通过。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - docs/zh/guide/cross_gen_migration_guide/3510_arch_migration/2201_to_3510_guide/basic_api_migration.md：全面重写迁移指导，扩充章节内容，优化代码示例展示格式 - docs/zh/guide/figures/fig_5_zn.png、fig_6_zn.png：新增L0A Buffer复用场景分形适配示意图 - examples/01_simd_cpp_api/06_compatibility_guide/subnormal/README.md、README_en.md：新增Subnormal兼容性样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/fixpipe_params_switch/README.md、README_en.md：新增Fixpipe参数结构体切换样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/pattern_transformation/README.md、README_en.md：更新代码示例 - examples/01_simd_cpp_api/06_compatibility_guide/README.md、README_en.md：更新样例索引 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5577 | 15 天前 | |
优化兼容性手册 Co-authored-by: zhuangjinjun<zhuangjinjun@huawei.com> # message auto-generated for no-merge-commit merge: !5577 merge opt-example into master 优化兼容性手册 Created-by: printfscanfmain Commit-by: zhuangjinjun Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次改动围绕2201到3510架构基础API迁移指导文档及其配套兼容性样例进行全面完善，主要包括以下方面： 1. **迁移指导文档完善**（ basic_api_migration.md）：重写并扩充迁移指导内容，新增Fixpipe参数结构体切换（NZ2ND/NZ2NZ场景）、GM→L0A/L0B通路拆分、L0A/L0B Buffer初始化适配等章节；将样例代码位置信息从独立段落转移到代码块注释中（改为"参考样例代码行"格式）；补充末尾句号；将锚点从 <a name> 统一改为 <a id>；新增图5/图6说明L0A Buffer复用场景的分形适配。 2. **新增样例**：新增 subnormal 和 fixpipe_params_switch 两个完整兼容性样例（含CMakeLists.txt、README、scripts、.asc、data_utils.h）。 3. **样例错误处理加固**：对全部7个样例的 main() 函数进行加固——用 CHECK_ACL 宏包装所有ACL调用（aclInit/aclrtSetDevice/aclrtMalloc/aclrtMemcpy等），指针声明初始化为 nullptr，检查 ReadFile/WriteFile 返回值并在失败时打印 ERROR_LOG 并 return -1；在5个样例的 data_utils.h 中补充 CHECK_ACL 宏定义。 4. **样例接口更新**：将 set_loaddata_boundary 中的 DivCeil 替换为 AscendC::Std::ceil_div，与其它样例统一使用最新工具接口；将 SetLoadDataRepeat/SetLoadDataRepeatWithStride 的聚合初始化改为显式结构体成员赋值；完善 pattern_transformation 中3510分支的L1→L0B搬运逻辑（新增 LoadData2DParamsV2 路径）。 5. **README更新**：更新 pattern_transformation 的中英文README，补充完整的代码示例；更新兼容性样例总README索引。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 无 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。-->  | 样例 | NPU | CPU | |------|-----|-----| | subnormal | test pass! | test pass! | | data_copy_l1togm | test pass! | test pass! | | set_loaddata_boundary | test pass! | test pass! | | matmul_s4 | test pass! | test pass! | | pattern_transformation | test pass! | test pass! | | fill | test pass! | test pass! | | fixpipe_params_switch | test pass! | test pass! | 编译架构：dav-3510，验证脚本输出 test pass! 确认精度通过。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - docs/zh/guide/cross_gen_migration_guide/3510_arch_migration/2201_to_3510_guide/basic_api_migration.md：全面重写迁移指导，扩充章节内容，优化代码示例展示格式 - docs/zh/guide/figures/fig_5_zn.png、fig_6_zn.png：新增L0A Buffer复用场景分形适配示意图 - examples/01_simd_cpp_api/06_compatibility_guide/subnormal/README.md、README_en.md：新增Subnormal兼容性样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/fixpipe_params_switch/README.md、README_en.md：新增Fixpipe参数结构体切换样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/pattern_transformation/README.md、README_en.md：更新代码示例 - examples/01_simd_cpp_api/06_compatibility_guide/README.md、README_en.md：更新样例索引 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5577 | 15 天前 | |
修复issue 1409和issue 1472 Co-authored-by: cgcaof<caochenguang1@h-partners.com> # message auto-generated for no-merge-commit merge: !5100 merge master into master 修复issue 1409和issue 1472 Created-by: cgcaof Commit-by: cgcaof Merged-by: cann-robot Description: ## 描述 修复issue 1409，文档链接指向错误 修复issue 1472，链接名称错误 ## 关联的Issue https://gitcode.com/cann/asc-devkit/issues/1409 https://gitcode.com/cann/asc-devkit/issues/1472 ## 测试 不涉及 ## 文档更新 docs/zh/guide/算子实践参考/SIMD算子实现/融合算子编程/CV融合/算子实现.md ## 类型标签 <!-- [x] 表示选中 --> - [x] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5100 | 1 个月前 | |
优化兼容性手册 Co-authored-by: zhuangjinjun<zhuangjinjun@huawei.com> # message auto-generated for no-merge-commit merge: !5577 merge opt-example into master 优化兼容性手册 Created-by: printfscanfmain Commit-by: zhuangjinjun Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次改动围绕2201到3510架构基础API迁移指导文档及其配套兼容性样例进行全面完善，主要包括以下方面： 1. **迁移指导文档完善**（ basic_api_migration.md）：重写并扩充迁移指导内容，新增Fixpipe参数结构体切换（NZ2ND/NZ2NZ场景）、GM→L0A/L0B通路拆分、L0A/L0B Buffer初始化适配等章节；将样例代码位置信息从独立段落转移到代码块注释中（改为"参考样例代码行"格式）；补充末尾句号；将锚点从 <a name> 统一改为 <a id>；新增图5/图6说明L0A Buffer复用场景的分形适配。 2. **新增样例**：新增 subnormal 和 fixpipe_params_switch 两个完整兼容性样例（含CMakeLists.txt、README、scripts、.asc、data_utils.h）。 3. **样例错误处理加固**：对全部7个样例的 main() 函数进行加固——用 CHECK_ACL 宏包装所有ACL调用（aclInit/aclrtSetDevice/aclrtMalloc/aclrtMemcpy等），指针声明初始化为 nullptr，检查 ReadFile/WriteFile 返回值并在失败时打印 ERROR_LOG 并 return -1；在5个样例的 data_utils.h 中补充 CHECK_ACL 宏定义。 4. **样例接口更新**：将 set_loaddata_boundary 中的 DivCeil 替换为 AscendC::Std::ceil_div，与其它样例统一使用最新工具接口；将 SetLoadDataRepeat/SetLoadDataRepeatWithStride 的聚合初始化改为显式结构体成员赋值；完善 pattern_transformation 中3510分支的L1→L0B搬运逻辑（新增 LoadData2DParamsV2 路径）。 5. **README更新**：更新 pattern_transformation 的中英文README，补充完整的代码示例；更新兼容性样例总README索引。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 无 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。-->  | 样例 | NPU | CPU | |------|-----|-----| | subnormal | test pass! | test pass! | | data_copy_l1togm | test pass! | test pass! | | set_loaddata_boundary | test pass! | test pass! | | matmul_s4 | test pass! | test pass! | | pattern_transformation | test pass! | test pass! | | fill | test pass! | test pass! | | fixpipe_params_switch | test pass! | test pass! | 编译架构：dav-3510，验证脚本输出 test pass! 确认精度通过。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - docs/zh/guide/cross_gen_migration_guide/3510_arch_migration/2201_to_3510_guide/basic_api_migration.md：全面重写迁移指导，扩充章节内容，优化代码示例展示格式 - docs/zh/guide/figures/fig_5_zn.png、fig_6_zn.png：新增L0A Buffer复用场景分形适配示意图 - examples/01_simd_cpp_api/06_compatibility_guide/subnormal/README.md、README_en.md：新增Subnormal兼容性样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/fixpipe_params_switch/README.md、README_en.md：新增Fixpipe参数结构体切换样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/pattern_transformation/README.md、README_en.md：更新代码示例 - examples/01_simd_cpp_api/06_compatibility_guide/README.md、README_en.md：更新样例索引 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5577 | 15 天前 | |
优化兼容性手册 Co-authored-by: zhuangjinjun<zhuangjinjun@huawei.com> # message auto-generated for no-merge-commit merge: !5577 merge opt-example into master 优化兼容性手册 Created-by: printfscanfmain Commit-by: zhuangjinjun Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次改动围绕2201到3510架构基础API迁移指导文档及其配套兼容性样例进行全面完善，主要包括以下方面： 1. **迁移指导文档完善**（ basic_api_migration.md）：重写并扩充迁移指导内容，新增Fixpipe参数结构体切换（NZ2ND/NZ2NZ场景）、GM→L0A/L0B通路拆分、L0A/L0B Buffer初始化适配等章节；将样例代码位置信息从独立段落转移到代码块注释中（改为"参考样例代码行"格式）；补充末尾句号；将锚点从 <a name> 统一改为 <a id>；新增图5/图6说明L0A Buffer复用场景的分形适配。 2. **新增样例**：新增 subnormal 和 fixpipe_params_switch 两个完整兼容性样例（含CMakeLists.txt、README、scripts、.asc、data_utils.h）。 3. **样例错误处理加固**：对全部7个样例的 main() 函数进行加固——用 CHECK_ACL 宏包装所有ACL调用（aclInit/aclrtSetDevice/aclrtMalloc/aclrtMemcpy等），指针声明初始化为 nullptr，检查 ReadFile/WriteFile 返回值并在失败时打印 ERROR_LOG 并 return -1；在5个样例的 data_utils.h 中补充 CHECK_ACL 宏定义。 4. **样例接口更新**：将 set_loaddata_boundary 中的 DivCeil 替换为 AscendC::Std::ceil_div，与其它样例统一使用最新工具接口；将 SetLoadDataRepeat/SetLoadDataRepeatWithStride 的聚合初始化改为显式结构体成员赋值；完善 pattern_transformation 中3510分支的L1→L0B搬运逻辑（新增 LoadData2DParamsV2 路径）。 5. **README更新**：更新 pattern_transformation 的中英文README，补充完整的代码示例；更新兼容性样例总README索引。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 无 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。-->  | 样例 | NPU | CPU | |------|-----|-----| | subnormal | test pass! | test pass! | | data_copy_l1togm | test pass! | test pass! | | set_loaddata_boundary | test pass! | test pass! | | matmul_s4 | test pass! | test pass! | | pattern_transformation | test pass! | test pass! | | fill | test pass! | test pass! | | fixpipe_params_switch | test pass! | test pass! | 编译架构：dav-3510，验证脚本输出 test pass! 确认精度通过。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - docs/zh/guide/cross_gen_migration_guide/3510_arch_migration/2201_to_3510_guide/basic_api_migration.md：全面重写迁移指导，扩充章节内容，优化代码示例展示格式 - docs/zh/guide/figures/fig_5_zn.png、fig_6_zn.png：新增L0A Buffer复用场景分形适配示意图 - examples/01_simd_cpp_api/06_compatibility_guide/subnormal/README.md、README_en.md：新增Subnormal兼容性样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/fixpipe_params_switch/README.md、README_en.md：新增Fixpipe参数结构体切换样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/pattern_transformation/README.md、README_en.md：更新代码示例 - examples/01_simd_cpp_api/06_compatibility_guide/README.md、README_en.md：更新样例索引 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5577 | 15 天前 | |
优化兼容性手册 Co-authored-by: zhuangjinjun<zhuangjinjun@huawei.com> # message auto-generated for no-merge-commit merge: !5577 merge opt-example into master 优化兼容性手册 Created-by: printfscanfmain Commit-by: zhuangjinjun Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次改动围绕2201到3510架构基础API迁移指导文档及其配套兼容性样例进行全面完善，主要包括以下方面： 1. **迁移指导文档完善**（ basic_api_migration.md）：重写并扩充迁移指导内容，新增Fixpipe参数结构体切换（NZ2ND/NZ2NZ场景）、GM→L0A/L0B通路拆分、L0A/L0B Buffer初始化适配等章节；将样例代码位置信息从独立段落转移到代码块注释中（改为"参考样例代码行"格式）；补充末尾句号；将锚点从 <a name> 统一改为 <a id>；新增图5/图6说明L0A Buffer复用场景的分形适配。 2. **新增样例**：新增 subnormal 和 fixpipe_params_switch 两个完整兼容性样例（含CMakeLists.txt、README、scripts、.asc、data_utils.h）。 3. **样例错误处理加固**：对全部7个样例的 main() 函数进行加固——用 CHECK_ACL 宏包装所有ACL调用（aclInit/aclrtSetDevice/aclrtMalloc/aclrtMemcpy等），指针声明初始化为 nullptr，检查 ReadFile/WriteFile 返回值并在失败时打印 ERROR_LOG 并 return -1；在5个样例的 data_utils.h 中补充 CHECK_ACL 宏定义。 4. **样例接口更新**：将 set_loaddata_boundary 中的 DivCeil 替换为 AscendC::Std::ceil_div，与其它样例统一使用最新工具接口；将 SetLoadDataRepeat/SetLoadDataRepeatWithStride 的聚合初始化改为显式结构体成员赋值；完善 pattern_transformation 中3510分支的L1→L0B搬运逻辑（新增 LoadData2DParamsV2 路径）。 5. **README更新**：更新 pattern_transformation 的中英文README，补充完整的代码示例；更新兼容性样例总README索引。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 无 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。-->  | 样例 | NPU | CPU | |------|-----|-----| | subnormal | test pass! | test pass! | | data_copy_l1togm | test pass! | test pass! | | set_loaddata_boundary | test pass! | test pass! | | matmul_s4 | test pass! | test pass! | | pattern_transformation | test pass! | test pass! | | fill | test pass! | test pass! | | fixpipe_params_switch | test pass! | test pass! | 编译架构：dav-3510，验证脚本输出 test pass! 确认精度通过。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - docs/zh/guide/cross_gen_migration_guide/3510_arch_migration/2201_to_3510_guide/basic_api_migration.md：全面重写迁移指导，扩充章节内容，优化代码示例展示格式 - docs/zh/guide/figures/fig_5_zn.png、fig_6_zn.png：新增L0A Buffer复用场景分形适配示意图 - examples/01_simd_cpp_api/06_compatibility_guide/subnormal/README.md、README_en.md：新增Subnormal兼容性样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/fixpipe_params_switch/README.md、README_en.md：新增Fixpipe参数结构体切换样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/pattern_transformation/README.md、README_en.md：更新代码示例 - examples/01_simd_cpp_api/06_compatibility_guide/README.md、README_en.md：更新样例索引 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5577 | 15 天前 | |
优化兼容性手册 Co-authored-by: zhuangjinjun<zhuangjinjun@huawei.com> # message auto-generated for no-merge-commit merge: !5577 merge opt-example into master 优化兼容性手册 Created-by: printfscanfmain Commit-by: zhuangjinjun Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本次改动围绕2201到3510架构基础API迁移指导文档及其配套兼容性样例进行全面完善，主要包括以下方面： 1. **迁移指导文档完善**（ basic_api_migration.md）：重写并扩充迁移指导内容，新增Fixpipe参数结构体切换（NZ2ND/NZ2NZ场景）、GM→L0A/L0B通路拆分、L0A/L0B Buffer初始化适配等章节；将样例代码位置信息从独立段落转移到代码块注释中（改为"参考样例代码行"格式）；补充末尾句号；将锚点从 <a name> 统一改为 <a id>；新增图5/图6说明L0A Buffer复用场景的分形适配。 2. **新增样例**：新增 subnormal 和 fixpipe_params_switch 两个完整兼容性样例（含CMakeLists.txt、README、scripts、.asc、data_utils.h）。 3. **样例错误处理加固**：对全部7个样例的 main() 函数进行加固——用 CHECK_ACL 宏包装所有ACL调用（aclInit/aclrtSetDevice/aclrtMalloc/aclrtMemcpy等），指针声明初始化为 nullptr，检查 ReadFile/WriteFile 返回值并在失败时打印 ERROR_LOG 并 return -1；在5个样例的 data_utils.h 中补充 CHECK_ACL 宏定义。 4. **样例接口更新**：将 set_loaddata_boundary 中的 DivCeil 替换为 AscendC::Std::ceil_div，与其它样例统一使用最新工具接口；将 SetLoadDataRepeat/SetLoadDataRepeatWithStride 的聚合初始化改为显式结构体成员赋值；完善 pattern_transformation 中3510分支的L1→L0B搬运逻辑（新增 LoadData2DParamsV2 路径）。 5. **README更新**：更新 pattern_transformation 的中英文README，补充完整的代码示例；更新兼容性样例总README索引。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 无 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。-->  | 样例 | NPU | CPU | |------|-----|-----| | subnormal | test pass! | test pass! | | data_copy_l1togm | test pass! | test pass! | | set_loaddata_boundary | test pass! | test pass! | | matmul_s4 | test pass! | test pass! | | pattern_transformation | test pass! | test pass! | | fill | test pass! | test pass! | | fixpipe_params_switch | test pass! | test pass! | 编译架构：dav-3510，验证脚本输出 test pass! 确认精度通过。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - docs/zh/guide/cross_gen_migration_guide/3510_arch_migration/2201_to_3510_guide/basic_api_migration.md：全面重写迁移指导，扩充章节内容，优化代码示例展示格式 - docs/zh/guide/figures/fig_5_zn.png、fig_6_zn.png：新增L0A Buffer复用场景分形适配示意图 - examples/01_simd_cpp_api/06_compatibility_guide/subnormal/README.md、README_en.md：新增Subnormal兼容性样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/fixpipe_params_switch/README.md、README_en.md：新增Fixpipe参数结构体切换样例文档 - examples/01_simd_cpp_api/06_compatibility_guide/pattern_transformation/README.md、README_en.md：更新代码示例 - examples/01_simd_cpp_api/06_compatibility_guide/README.md、README_en.md：更新样例索引 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5577 | 15 天前 |
Compatibility Guide样例介绍
概述
针对Atlas A2 训练系列产品/Atlas A2 推理系列产品、Atlas A3 训练系列产品/Atlas A3 推理系列产品与Ascend 950PR/Ascend 950DT之间存在兼容性差异的部分特性，本小节提供了若干样例，用户可以根据样例进行迁移适配。 本小节样例使用<<<>>>内核调用符来完成算子核函数在NPU侧运行验证的基础流程，给出了对应的端到端实现。
样例列表
| 目录名称 | 功能描述 | 支持的产品 |
|---|---|---|
| data_copy_l1togm | 本样例演示L1数据搬运到GM的端到端流程。 | Ascend 950PR/Ascend 950DT Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas A2 推理系列产品 |
| fill | 本样例展示如何使用Fill接口对L0A Buffer和L0B Buffer进行初始化。 | Ascend 950PR/Ascend 950DT Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas A2 推理系列产品 |
| fixpipe_params_switch | 本样例演示Fixpipe接口在2201/3510两种架构下的参数结构体切换。 | Ascend 950PR/Ascend 950DT Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas A2 推理系列产品 |
| matmul_s4 | 本样例演示 int4 矩阵乘计算的端到端实现。 | Ascend 950PR/Ascend 950DT Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas A2 推理系列产品 |
| pattern_transformation | 本样例基于基础的mmad样例，演示了 L1 Buffer -> L0A Buffer 通路的分形转换逻辑。 | Ascend 950PR/Ascend 950DT Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas A2 推理系列产品 |
| scatter | 本样例演示数据离散功能，可根据输入张量和目的地址偏移张量，将输入张量分散到结果张量中。 | Ascend 950PR/Ascend 950DT Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas A2 推理系列产品 |
| set_loaddata_boundary | 本样例实现L1 Buffer边界值的设置。 | Ascend 950PR/Ascend 950DT Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas A2 推理系列产品 |
| subnormal | 本样例以Ln接口为例，演示矢量计算接口的Subnormal计算模式兼容性适配。 | Ascend 950PR/Ascend 950DT Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas A2 推理系列产品 |