mcgatom/codex-cannbot/ascendc-simt-best-practices

AscendC SIMT 最佳实践

本 skill 提供基于实际算子开发经验提炼的 SIMT 编程范式总结，以及 SIMT 专有 API 的分类索引和速查。SIMT 基础概念（核函数、线程架构、内存层级）请通过 ascendc-docs-search skill 查阅 $ASC_DEVKIT_DIR/docs/guide/编程指南/编程模型/AI-Core-SIMT编程/。

API 分类索引表

查阅完整 API 文档：使用 ascendc-docs-search skill 查阅 SIMT API 官方文档（find "$ASC_DEVKIT_DIR/docs/api/" -name "{APIName}*.md"）。

编程阶段分类索引

核心编程范式速查

// 1. VF 声明
template <typename T>
__simt_vf__ __aicore__ LAUNCH_BOUND(512) inline void OpSimt(
    uint64_t count, __gm__ T* x, __gm__ T* y);
 
// 2. VF 调用
AscendC::Simt::VF_CALL<OpSimt<T>>(AscendC::Simt::Dim3(512), count, (__gm__ T*)x, (__gm__ T*)y);
 
// 3. 线程排布 for 循环
for (uint64_t i = AscendC::Simt::GetBlockIdx() * AscendC::Simt::GetThreadNum() + AscendC::Simt::GetThreadIdx();
     i < count; i += AscendC::Simt::GetThreadNum() * AscendC::Simt::GetBlockNum()) { ... }

SIMT vs SIMD 差异速查

参考资料索引

references/ 按需加载：

编程最佳实践：

• vf-declaration.md -- VF 函数声明规范：__simt_vf__ 标记、LAUNCH_BOUND 约束、参数类型支持表
• vf-call.md -- VF_CALL 启动语法与完整示例：Add 算子模板、GM_ADDR 直接转换 vs GlobalTensor 中转
• thread-stride-pattern.md -- 线程排布统一 for 循环模式：索引计算分解、Select 算子示例
• index-calculation.md -- 索引计算 API 完整列表：GetThreadIdx/GetThreadNum/GetBlockIdx/GetBlockNum 返回类型与用法、头文件引用
• data-transfer.md -- 数据搬入搬出方案选择：GM 直接计算 vs UB 中转、tiling 侧 SetLocalMemorySize
• compute-operators.md -- 计算指令映射：C++ 运算符优先写法、显式 API 适用场景
• multi-core-sync.md -- 多核同步机制：workspace 交换、SyncAll、SetScheduleMode(1)、VF_CALL 间同步限制
• intra-core-shared.md -- 核内共享内存：TBuf 申请、__ubuf__ 指针传递、原子操作注意事项
• tensorlist-handling.md -- TensorList 动态输入处理：ListTensorDesc 内存布局、Host/Device 侧解析、VF 内解析 vs 外部解析选择建议

API 导航与速查：

• overview.md -- SIMT API 总览：VF启动机制、头文件映射、核函数定义、混合编程辅助函数速查
• debug-api.md -- 调测接口速查：printf/assert/__trap 使用要点
• macro-api.md -- 内置宏速查：特殊值(INF/NAN/MAX/MIN)、数学常数(pi/e/ln2等)

完整 API 文档：

• $ASC_DEVKIT_DIR -- 通过 ascendc-docs-search skill 查阅 SIMT API 文档