CANN/asc-devkit L1到GM数据搬运API

asc_copy_l12gm

【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit

产品支持情况

• Ascend 950PR/Ascend 950DT：不支持

• Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持

• Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持

• Atlas 200I/500 A2 推理产品：不支持

• Atlas 推理系列产品AI Core：不支持

• Atlas 推理系列产品Vector Core：不支持

• Atlas 训练系列产品：不支持

功能说明

头文件路径："c_api/cube_datamove/cube_datamove.h"。

将数据从L1 Buffer搬运到Global Memory。

函数原型

• 常规搬运

  __aicore__ inline void asc_copy_l12gm(__gm__ void* dst, __cbuf__ void* src, uint16_t n_burst, uint16_t len_burst, uint16_t src_gap, uint16_t dst_gap)

• 同步搬运

  __aicore__ inline void asc_copy_l12gm_sync(__gm__ void* dst, __cbuf__ void* src, uint16_t n_burst, uint16_t len_burst, uint16_t src_gap, uint16_t dst_gap)

参数说明

返回值说明

无

流水类型

PIPE_MTE1

约束说明

• src的起始地址要求按照对应数据类型所占字节数对齐。
• dst的起始地址要求32字节对齐。
• 如果需要执行多条asc_copy_l12gm指令，且asc_copy_l12gm指令的目的地址存在重叠，需要插入同步指令，保证多个asc_copy_l12gm指令的串行化，防止出现异常数据。

调用示例

//待搬运的连续传输数据块为1 constexpr uint16_t n_burst = 1; //待搬运的每个连续传输数据块的长度为32个字节 constexpr uint16_t len_burst = 1; //相邻迭代间，源操作数前一个分形与后一个分形起始地址的间隔为32个字节 constexpr uint16_t src_gap = 0; //相邻迭代间，目标操作数前一个分形与后一个分形起始地址的间隔为64个字节 constexpr uint16_t dst_gap = 1; __cbuf__ half src[256]; __gm__ half dst[256]; asc_copy_l12gm(dst, src, n_burst, len_burst, src_gap, dst_gap);

【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit