CANN/asc-devkit WaitPreTaskEnd任务间同步接口文档

WaitPreTaskEnd【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言原生支持C和C标准规范主要由类库和语言扩展层构成提供多层级API满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit[!NOTE]说明 本接口为试验接口在后续版本中可能会调整或改进不保证后续兼容性。请开发者在使用过程中关注后续版本更新。产品支持情况Ascend 950PR/Ascend 950DT支持该接口生效Atlas A3 训练系列产品/Atlas A3 推理系列产品支持该接口生效Atlas A2 训练系列产品/Atlas A2 推理系列产品支持仅保证编译兼容实际功能不生效。Atlas 200I/500 A2 推理产品支持仅保证编译兼容实际功能不生效。Atlas 推理系列产品AI Core支持仅保证编译兼容实际功能不生效。Atlas 推理系列产品Vector Core支持仅保证编译兼容实际功能不生效。Atlas 训练系列产品支持仅保证编译兼容实际功能不生效。Kirin X90支持仅保证编译兼容实际功能不生效。Kirin 9030支持仅保证编译兼容实际功能不生效。功能说明头文件路径为basic_api/kernel_operator_common_intf.h。算子层面支持SuperKernel特性Early-Start能力的接口调用后在TorchAir层面1.GE图模式下进行默认启用; 2.npugraph_ex后端通过early_start选项进行控制启用。在SuperKernel的子Kernel中调用调用前的指令可以和前序其他的子Kernel实现并行提升整体性能。如图1所示SuperKernel按序调用子Kernel为保证子Kernel之间数据互不干扰会在子Kernel间插入算子间同步进行保序子KernelN1调用该接口之前的指令会和前序子KernelN实现并行。SuperKernel是一种算子的二进制融合技术与源码融合不同它聚焦于内核函数 (Kernel)的二进制的调度方案展开深度优化于已编译的二进制代码基础上融合创建一个超级Kernel函数SuperKernel以调用子函数的方式调用多个其他内核函数也就是子Kernel。相对于单算子下发SuperKernel技术可以减少任务调度等待时间和调度开销同时利用Task间隙资源进一步优化算子头开销。开发者需要自行保证调用此接口前的指令不会与前序算子互相干扰而导致精度问题推荐在整个算子第一条搬运指令前调用此接口。图1通过WaitPreTaskEnd实现并行示意图函数原型templatebool FORCE false __aicore__ inline void WaitPreTaskEnd()参数说明表1模板参数说明参数名描述FORCE离线编译时是否强制启用Early-Start能力不影响在线编译。false离线编译时不强制启用Early-Start能力true离线编译时启用Early-Start能力适用于无在线编译流程的算子如开发的算子。返回值说明无约束说明该接口适用于TorchAir图模式开发场景且需在启用SuperKernel特性后方可生效。具体内容请参考《Ascend Extension for PyTorch》中“Pytorch图模式使用(TorchAir) max-autotune模式功能 图内标定SuperKernel范围”章节。在算子运行过程中需要保证此接口在每个核上都被调用且每个核上仅被调用一次。若子Kernel某个TilingKey分支调用了此接口则开发者需要保证当前算子可能会运行的所有TilingKey均调用了此接口否则会出现因同步指令数量不匹配而卡住的现象。调用示例AscendC::LocalMemAllocatorAscendC::Hardware::UB ubAllocator; AscendC::LocalTensorT src0Local ubAllocator.AllocT, TOTAL_LENGTH(); AscendC::LocalTensorT src1Local ubAllocator.AllocT, TOTAL_LENGTH(); AscendC::LocalTensorT dstLocal ubAllocator.AllocT, TOTAL_LENGTH(); // 在第一条搬运指令前调用使之前的指令可与前序子kernel并行执行。 AscendC::WaitPreTaskEnd(); AscendC::DataCopy(src0Local, src0Global, TOTAL_LENGTH); AscendC::DataCopy(src1Local, src1Global, TOTAL_LENGTH); AscendC::SetFlagAscendC::HardEvent::MTE2_V(EVENT_ID0); AscendC::WaitFlagAscendC::HardEvent::MTE2_V(EVENT_ID0); AscendC::Add(dstLocal, src0Local, src1Local, TOTAL_LENGTH);完整样例请参考TaskSync样例。【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言原生支持C和C标准规范主要由类库和语言扩展层构成提供多层级API满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考