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

📅 2026/7/16 21:20:17 👁️ 阅读次数 📝 编程学习
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)

参数说明

参数名输入/输出描述
dst输出目的操作数的起始地址。
src输入源操作数的起始地址。
n_burst输入待搬运的连续传输数据块个数。取值范围:[1, 4095]。
len_burst输入待搬运的每个连续传输数据块的长度,单位为32个字节。取值范围:[1, 65535]。
src_gap输入相邻迭代间,源操作数前一个迭代第一个分形的结束地址到下一个迭代第一个分形起始地址的间隔。
dst_gap输入相邻迭代间,目的操作数前一个迭代第一个分形的结束地址到下一个迭代第一个分形起始地址的间隔。单位为32字节。

返回值说明

流水类型

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考