master

文件	最后提交记录	最后更新时间
SIMD_SIMT_hybrid_programming_intro	feat: add asc_uintdiv SIMT API Co-authored-by: zhangshunwei2<zhangshunwei2@huawei.com> # message auto-generated for no-merge-commit merge: !6009 merge fastdiv_simt into master feat: add asc_uintdiv SIMT API Created-by: zhangshunwei2 Commit-by: zhangshunwei2 Merged-by: cann-robot Description: ## 描述 新增 C 风格 SIMT 快速整数除法接口，共两个，均支持 uint32/uint64： - asc_get_uintdiv_magic_and_shift：在核函数标量计算逻辑中根据除数预计算乘法因子 magic 和移位量 shift（该接口由 #6008 原 scalar 侧实现迁移至 simt_api/math_functions.h，与 asc_uintdiv 归置一处）。 - asc_uintdiv：在 SIMT VF 计算逻辑中根据被除数与预计算参数，通过无符号高位乘法、加法和右移计算整数商，适用于同一除数被大量数据复用的场景。 接口用于 Ascend 950（dav-3510）的 SIMD+SIMT 混合编程，不支持纯 SIMT 编程。两种位宽的被除数及对应除数最大值分别为 INT32_MAX、INT64_MAX。两个接口在同一头文件 simt_api/math_functions.h 中提供，调用示例为完整闭环（标量预计算 + asc_vf_call + VF 内快除），可独立编译。 ## 关联的Issue 关联 [Issue #1592](https://gitcode.com/cann/asc-devkit/issues/1592)。 ## 测试 - git diff --check upstream/master 通过。 - CANN 9.2.0 weekly 20260902、dav-3510 环境，使用本分支的公开头文件及实现编译独立 ASC 验证程序，并核对编译依赖路径。 - NPU 实测 uint32/uint64 各 8,241 组输入，均与 CPU 整数除法一致（0 mismatch）。每种位宽包含 49 组边界排列组合与 8,192 组固定种子的随机数据，覆盖 d=1、2、3、7、半域附近、INT*_MAX-1 和 INT*_MAX。 - 迁移后回归：ascendc_ut_simt_api_ascend950pr_9599 UT 265/265 通过（含 ASCENDC_CPU_DEBUG host 编译路径）；bisheng 设备编译、纯 SIMT（--enable-simt）宏排除、混合编程 NPU 全量样例（uint32/uint64 各 8388608 元素，普通/快速除法双场景）实测通过；cycle 级性能测量确认 uint32/uint64 快除相对普通除法的收益保持。 ## 文档更新 新增 asc_uintdiv、asc_get_uintdiv_magic_and_shift API 文档，给出高位乘法取整与预计算公式、约束及闭环调用示例；更新整数数学函数索引、混合编程 API 列表和 API 总目录。 ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [x] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6009	1 个月前
SIMT_programming_intro	修改缺少转义字符导致接口功能说明显示不完整 Co-authored-by: xuyiyang0324<xuyiyang6@huawei.com> # message auto-generated for no-merge-commit merge: !6056 merge master into master 修改缺少转义字符导致接口功能说明显示不完整 Created-by: xuyiyang0324 Commit-by: xuyiyang0324 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 1. 修复 __sad 和 __usad 描述显示不全问题 将描述中的绝对值符号： |x - y|+z 修改为： \|x - y\|+z 避免 Markdown 将 | 识别为表格列分隔符。 2. 修复 SIMT_programming_intro/api_list.md 中的句号缺失： - __high2half - normcdfinvf 3. 修复 SIMD_SIMT_hybrid_programming_intro/api_list.md 中的句号缺失： - __high2half - normcdfinvf ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> https://gitcode.com/cann/asc-devkit/issues/1668 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6056	1 个月前
Warp_functions	docs(warp): add measured IO examples Co-authored-by: lishangfan<lishangfan@h-partners.com> # message auto-generated for no-merge-commit merge: !6680 merge warp into master docs(warp): add measured IO examples Created-by: ruoshuisixue Commit-by: lishangfan Merged-by: cann-robot Description: ## 描述 本 PR 为 Warp 函数相关 API 文档补充输入输出示例，共更新 17 个 Markdown 文件，覆盖 docs/zh/api/SIMT-API/Warp_functions/ 下的四类函数： - Warp 归约函数：asc_reduce_add、asc_reduce_max、asc_reduce_min。 - Warp Shuffle 函数：asc_shfl、asc_shfl_down、asc_shfl_up、asc_shfl_xor。 - Warp Vote 函数：asc_activemask、asc_all、asc_any、asc_ballot。 - Lane ID 相关函数：laneid、lanemask_eq、lanemask_ge、lanemask_gt、lanemask_le、lanemask_lt。 每个文档在示例代码后新增统一的“输入输出示例如下”文本块。示例选取 8 个代表不同 Warp 分组和 lane 位置的输入值，展示归约、线程间数据交换、投票掩码以及 lane 掩码等函数的典型输出结果；对于无输入参数或输出为全局唯一结果的函数，则按实际函数形态仅展示 result。 本 PR 仅新增文档示例，不修改函数接口、示例代码或执行逻辑。 ## 关联的Issue https://gitcode.com/cann/asc-devkit/issues/1856 ## 测试 本 PR 仅修改 Markdown 文档，不涉及算子实现、示例代码执行逻辑或构建配置，因此无需执行二级冒烟、算子泛化等运行测试。 已完成的文档校验： - 确认变更范围：17 个文件全部位于 docs/zh/api/SIMT-API/Warp_functions/ 目录，每个文件新增一个输入输出示例块。 - 检查 Markdown 结构：新增块的提示语、空行、 `text 代码围栏和结尾围栏完整，17 个示例块均闭合。 - 校验示例格式：标签均使用半角冒号，多个数值均使用英文逗号加空格分隔。 - 校验输入输出形态：按函数类型检查 x、y、result 标签；向量输入和逐线程输出的元素数量保持一致，归约、投票和全局唯一结果则按函数语义展示单一结果。 ## 文档更新 更新了 docs/zh/api/SIMT-API/Warp_functions/ 下 17 个 API 文档，为 Warp 归约、Warp Shuffle、Warp Vote 以及 Lane ID 相关函数补充输入输出示例。 ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6680	3 天前
address_space_conversion_functions	docs(address): add measured IO examples Co-authored-by: lishangfan<lishangfan@h-partners.com> # message auto-generated for no-merge-commit merge: !6731 merge address_sapce into master docs(address): add measured IO examples Created-by: ruoshuisixue Commit-by: lishangfan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本 PR 为 SIMT 地址空间相关 API 文档补充上板实测的输入输出示例，共更新 9 个 Markdown 文件，覆盖 docs/zh/api/SIMT-API/ 下两类接口： - 地址空间转换函数：__cvta_generic_to_global、__cvta_generic_to_local、__cvta_generic_to_ubuf、__cvta_global_to_generic、__cvta_local_to_generic、__cvta_ubuf_to_generic。 - 地址空间判断函数：__isGlobal、__isLocal、__isUbuf。 每个文档均在现有调用示例后新增统一的“输入输出示例如下”文本块，展示典型输入数据以及地址转换、地址判断接口对应的实际输出结果。转换类示例展示 Global Memory 偏移量、Local 栈偏移量或 UB 地址值等输出；判断类示例展示对指定地址空间的判定结果。 本 PR 仅新增文档示例，不修改 API 定义、示例代码逻辑或构建配置。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> https://gitcode.com/cann/asc-devkit/issues/1856 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 本 PR 仅修改 Markdown 文档，不涉及算子实现、示例代码执行逻辑或构建配置，因此无需执行二级冒烟、算子泛化等运行测试。 已完成的文档校验： - 确认变更范围：9 个文件全部位于 address_space_conversion_functions 和 address_space_predicate_functions 目录，每个文件新增一个输入输出示例块。 - 检查 Markdown 结构：新增提示语、空行、 `text 代码围栏和结尾围栏完整，9 个示例块均闭合。 - 校验示例格式：标签使用半角冒号，多个数值使用英文逗号加空格分隔。 - 校验输入输出形态：转换类示例按 src/addr_val 与实际地址输出或 result 对应展示；判断类示例的 x 与 result 逐项对应。 - 示例数据均来自 NPU 上板实测，未改动接口行为。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新了 docs/zh/api/SIMT-API/address_space_conversion_functions/ 下 6 个地址转换 API 文档，以及 docs/zh/api/SIMT-API/address_space_predicate_functions/ 下 3 个地址判断 API 文档，为其补充实测输入输出示例。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6731	3 天前
address_space_predicate_functions	docs(address): add measured IO examples Co-authored-by: lishangfan<lishangfan@h-partners.com> # message auto-generated for no-merge-commit merge: !6731 merge address_sapce into master docs(address): add measured IO examples Created-by: ruoshuisixue Commit-by: lishangfan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本 PR 为 SIMT 地址空间相关 API 文档补充上板实测的输入输出示例，共更新 9 个 Markdown 文件，覆盖 docs/zh/api/SIMT-API/ 下两类接口： - 地址空间转换函数：__cvta_generic_to_global、__cvta_generic_to_local、__cvta_generic_to_ubuf、__cvta_global_to_generic、__cvta_local_to_generic、__cvta_ubuf_to_generic。 - 地址空间判断函数：__isGlobal、__isLocal、__isUbuf。 每个文档均在现有调用示例后新增统一的“输入输出示例如下”文本块，展示典型输入数据以及地址转换、地址判断接口对应的实际输出结果。转换类示例展示 Global Memory 偏移量、Local 栈偏移量或 UB 地址值等输出；判断类示例展示对指定地址空间的判定结果。 本 PR 仅新增文档示例，不修改 API 定义、示例代码逻辑或构建配置。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> https://gitcode.com/cann/asc-devkit/issues/1856 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 本 PR 仅修改 Markdown 文档，不涉及算子实现、示例代码执行逻辑或构建配置，因此无需执行二级冒烟、算子泛化等运行测试。 已完成的文档校验： - 确认变更范围：9 个文件全部位于 address_space_conversion_functions 和 address_space_predicate_functions 目录，每个文件新增一个输入输出示例块。 - 检查 Markdown 结构：新增提示语、空行、 `text 代码围栏和结尾围栏完整，9 个示例块均闭合。 - 校验示例格式：标签使用半角冒号，多个数值使用英文逗号加空格分隔。 - 校验输入输出形态：转换类示例按 src/addr_val 与实际地址输出或 result 对应展示；判断类示例的 x 与 result 逐项对应。 - 示例数据均来自 NPU 上板实测，未改动接口行为。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新了 docs/zh/api/SIMT-API/address_space_conversion_functions/ 下 6 个地址转换 API 文档，以及 docs/zh/api/SIMT-API/address_space_predicate_functions/ 下 3 个地址判断 API 文档，为其补充实测输入输出示例。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6731	3 天前
atomic_operations	docs: 规范api和guide目录产品名称描述 Co-authored-by: munanhw<munan@huawei.com> # message auto-generated for no-merge-commit merge: !6250 merge master into master docs: 规范api和guide目录产品名称描述 Created-by: munanhw Commit-by: munanhw Merged-by: cann-robot Description: ## 描述 按产品名称映射表规范化docs/zh/api和docs/zh/guide目录中的产品名称描述（2461个文件，18496处）： - Ascend 950PR/Ascend 950DT → Ascend 950PR&950DT系列产品 - Atlas A3 训练系列产品/Atlas A3 推理系列产品 → Atlas A3系列产品 - Atlas A2 训练系列产品/Atlas A2 推理系列产品 → Atlas A2系列产品 - Atlas 200I/500 A2 推理产品 → Atlas 200I/500 A2推理产品 - Atlas 推理系列产品AI Core/Vector Core → Atlas推理系列产品AI Core/Vector Core - Atlas 训练系列产品 → Atlas训练系列产品 所有变更行已通过脚本校验，均可由映射表规则解释，无其他内容改动。 ## 关联的Issue 无 ## 测试 纯文档名称替换，行数无增减（+18496/-18496），npu过滤注释保持不变。 ## 文档更新 docs/zh/api与docs/zh/guide目录下2461个md文件 ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6250	1 个月前
cooperative_groups	docs(cooperative-groups): add measured IO examples Co-authored-by: lishangfan<lishangfan@h-partners.com> # message auto-generated for no-merge-commit merge: !6734 merge cooperative_groups into master docs(cooperative-groups): add measured IO examples Created-by: ruoshuisixue Commit-by: lishangfan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本 PR 为 SIMT Cooperative Groups 相关 API 文档补充上板实测的输入输出示例，共更新 56 个 Markdown 文件，全部位于 docs/zh/api/SIMT-API/cooperative_groups/ 目录，覆盖以下接口类别： - 顶层分组与划分接口：binary_partition、tiled_partition、sync。 - coalesced_group：构造、同步、线程编号、组大小、元组信息、投票以及 Shuffle 接口。 - grid_group：构造、合法性、Block/Grid 编号与维度、线程数量、组大小、同步和线程编号接口。 - thread_block：构造、同步、线程编号、线程索引、组索引、维度和线程数量接口。 - thread_block_tile：构造、同步、线程编号、组大小、元组信息、投票以及 Shuffle 接口。 - thread_group：构造、类型、同步、线程编号、组大小和线程数量接口。 每个文档均在现有调用示例后新增统一的“输入输出示例如下”文本块，展示分组、线程编号、组属性、同步、投票或 Shuffle 操作对应的实际输出；对于按线程逐项输出的接口，结果按线程顺序列出，便于直接理解接口语义和执行结果。 本 PR 仅新增文档示例，不修改 API 定义、示例代码逻辑或构建配置。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> https://gitcode.com/cann/asc-devkit/issues/1856 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 本 PR 仅修改 Markdown 文档，不涉及算子实现、示例代码执行逻辑或构建配置，因此无需执行二级冒烟、算子泛化等运行测试。 已完成的文档校验： - 确认变更范围：56 个文件全部位于 docs/zh/api/SIMT-API/cooperative_groups/ 目录，每个文件新增一个输入输出示例块。 - 检查 Markdown 结构：新增提示语、空行、 `text 代码围栏和结尾围栏完整，56 个示例块均闭合。 - 校验示例格式：标签使用半角冒号，多个数值使用英文逗号加空格分隔。 - 校验输入输出形态：输入与输出数量按线程/元素逐项对应；无显式输入的接口按实际函数形态仅展示 result。 - 示例数据均来自 NPU 上板实测，未改动接口行为。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新了 docs/zh/api/SIMT-API/cooperative_groups/ 下 56 个 API 文档，为顶层分组与划分、coalesced_group、grid_group、thread_block、thread_block_tile 和 thread_group 相关接口补充实测输入输出示例。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6734	3 天前
math_functions	docs: figures图片文件名去除zh-cn_前缀并同步更新引用 Co-authored-by: ai_xin<aixin2@hisilicon.com> # message auto-generated for no-merge-commit merge: !6788 merge master into master docs: figures图片文件名去除zh-cn_前缀并同步更新引用 Created-by: ai_xin Commit-by: ai_xin Merged-by: cann-robot Description: ## 描述 docs: figures图片文件名去除zh-cn_前缀并同步更新引用 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 更新了docs/zh下md文件。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6788	5 天前
memory_access_functions	docs(memory): add measured IO examples Co-authored-by: lishangfan<lishangfan@h-partners.com> # message auto-generated for no-merge-commit merge: !6722 merge memory_sync into master docs(memory): add measured IO examples Created-by: ruoshuisixue Commit-by: lishangfan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本 PR 为 SIMT 内存访问、内存栅栏与同步相关 API 文档补充上板实测的输入输出示例，共更新 10 个 Markdown 文件，覆盖三类接口： - 内存访问函数：asc_dcci_entire、asc_dcci_single、asc_ldca、asc_ldcg、asc_nop、asc_stcg、asc_stwt。 - 内存栅栏函数：asc_threadfence、asc_threadfence_block。 - 线程块同步接口：asc_syncthreads。 每个文档均在现有调用示例后新增统一的“输入输出示例如下”文本块，展示典型输入数据、标志位状态或同步前数据，以及接口调用后的实际输出结果；asc_ldca/asc_ldcg/asc_stcg/asc_stwt 使用 half 数据展示读写结果，DCC invalidate 与栅栏/同步类接口则展示标志位、数据和最终结果之间的关系。 同时，asc_dcci_entire 和 asc_dcci_single 文档中的两个示例均将 while (data[0] != 1) 调整为 while (*(volatile uint32_t *)data != 1)，确保轮询标志位时每次都从内存读取最新值，避免编译器优化或缓存导致示例行为不符合预期。 本 PR 仅更新文档与文档内示例代码，不修改 API 实现、测试工程或构建配置。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> https://gitcode.com/cann/asc-devkit/issues/1856 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 本 PR 仅修改 Markdown 文档与文档内示例代码，不涉及算子实现、测试工程或构建配置，因此无需执行二级冒烟、算子泛化等运行测试。 已完成的文档校验： - 确认变更范围：10 个文件分别位于 memory_access_functions、sync_and_memory_fence/memory_fence 和 sync_and_memory_fence/sync_interface 目录，每个文件新增一个输入输出示例块。 - 检查示例代码调整：asc_dcci_entire 和 asc_dcci_single 中共有 4 处标志位轮询改为 volatile 读取，其余文档未修改示例代码。 - 检查 Markdown 结构：新增提示语、空行、 `text 代码围栏和结尾围栏完整，10 个示例块均闭合。 - 校验示例格式：标签使用半角冒号，多个数值使用英文逗号加空格分隔，省略输出使用 … 保持一致。 - 校验输入输出形态：读写类示例的 x/val 与 result 逐项对应；同步与栅栏类示例按 data、flag、result 展示状态变化。 - 新增示例数据均来自 NPU 上板实测，asc_dcci_entire、asc_dcci_single 的 volatile 轮询示例已验证能读到最新标志位并得到正确结果。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新了 docs/zh/api/SIMT-API/memory_access_functions/ 下 7 个内存访问 API 文档、docs/zh/api/SIMT-API/sync_and_memory_fence/memory_fence/ 下 2 个内存栅栏 API 文档，以及 docs/zh/api/SIMT-API/sync_and_memory_fence/sync_interface/asc_syncthreads.md，为其补充实测输入输出示例；并修正 DCC invalidate 两个示例中的标志位轮询读取方式。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6722	3 天前
sync_and_memory_fence	docs(memory): add measured IO examples Co-authored-by: lishangfan<lishangfan@h-partners.com> # message auto-generated for no-merge-commit merge: !6722 merge memory_sync into master docs(memory): add measured IO examples Created-by: ruoshuisixue Commit-by: lishangfan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 本 PR 为 SIMT 内存访问、内存栅栏与同步相关 API 文档补充上板实测的输入输出示例，共更新 10 个 Markdown 文件，覆盖三类接口： - 内存访问函数：asc_dcci_entire、asc_dcci_single、asc_ldca、asc_ldcg、asc_nop、asc_stcg、asc_stwt。 - 内存栅栏函数：asc_threadfence、asc_threadfence_block。 - 线程块同步接口：asc_syncthreads。 每个文档均在现有调用示例后新增统一的“输入输出示例如下”文本块，展示典型输入数据、标志位状态或同步前数据，以及接口调用后的实际输出结果；asc_ldca/asc_ldcg/asc_stcg/asc_stwt 使用 half 数据展示读写结果，DCC invalidate 与栅栏/同步类接口则展示标志位、数据和最终结果之间的关系。 同时，asc_dcci_entire 和 asc_dcci_single 文档中的两个示例均将 while (data[0] != 1) 调整为 while (*(volatile uint32_t *)data != 1)，确保轮询标志位时每次都从内存读取最新值，避免编译器优化或缓存导致示例行为不符合预期。 本 PR 仅更新文档与文档内示例代码，不修改 API 实现、测试工程或构建配置。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> https://gitcode.com/cann/asc-devkit/issues/1856 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 本 PR 仅修改 Markdown 文档与文档内示例代码，不涉及算子实现、测试工程或构建配置，因此无需执行二级冒烟、算子泛化等运行测试。 已完成的文档校验： - 确认变更范围：10 个文件分别位于 memory_access_functions、sync_and_memory_fence/memory_fence 和 sync_and_memory_fence/sync_interface 目录，每个文件新增一个输入输出示例块。 - 检查示例代码调整：asc_dcci_entire 和 asc_dcci_single 中共有 4 处标志位轮询改为 volatile 读取，其余文档未修改示例代码。 - 检查 Markdown 结构：新增提示语、空行、 `text 代码围栏和结尾围栏完整，10 个示例块均闭合。 - 校验示例格式：标签使用半角冒号，多个数值使用英文逗号加空格分隔，省略输出使用 … 保持一致。 - 校验输入输出形态：读写类示例的 x/val 与 result 逐项对应；同步与栅栏类示例按 data、flag、result 展示状态变化。 - 新增示例数据均来自 NPU 上板实测，asc_dcci_entire、asc_dcci_single 的 volatile 轮询示例已验证能读到最新标志位并得到正确结果。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 更新了 docs/zh/api/SIMT-API/memory_access_functions/ 下 7 个内存访问 API 文档、docs/zh/api/SIMT-API/sync_and_memory_fence/memory_fence/ 下 2 个内存栅栏 API 文档，以及 docs/zh/api/SIMT-API/sync_and_memory_fence/sync_interface/asc_syncthreads.md，为其补充实测输入输出示例；并修正 DCC invalidate 两个示例中的标志位轮询读取方式。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6722	3 天前
SIMT-API.md	refactor(docs): 重命名 SIMT-API/AI-CPU-API/Utils-API/附录 目录及文件为英文小写下划线 Co-authored-by: munan<munan@huawei.com> # message auto-generated for no-merge-commit merge: !4866 merge master into master refactor(docs): 重命名 SIMT-API/AI-CPU-API/Utils-API/附录 目录及文件为英文小写下划线 Created-by: munanhw Commit-by: munan Merged-by: cann-robot Description: ## 描述 refactor(docs): 重命名 SIMT-API/AI-CPU-API/Utils-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!4866	2 个月前
overview.md	同步ub和kernel Co-authored-by: haipingmao<maohaiping@huawei.com> # message auto-generated for no-merge-commit merge: !5145 merge br_refactor_kernel_ub_name into master 同步ub和kernel Created-by: haipingmao Commit-by: haipingmao Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 统一资料中UB和核函数Kernel的称呼 - 在一篇文档中，第一次出现的地方使用Unified Buffer（UB），后续采用UB。 - 将核函数/Kernel/核函数Kernel等统一为：核函数（Kernel） ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> NA ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> compile ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - docs/zh下所有文件信息 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!5145	2 个月前