asc_copy_l12gm

产品支持情况

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

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

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

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

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

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

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

功能说明

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

函数原型

• 常规搬运

  C++

  __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)
  

• 同步搬运

  C++

  __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)
  

参数说明

表1 参数说明

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

返回值说明

无

流水类型

PIPE_MTE1

约束说明

• 各存储单元的空间大小和对齐要求请参考存储单元说明。
• 如果需要执行多条asc_copy_l12gm指令，且asc_copy_l12gm指令的目的地址存在重叠，需要插入同步指令，保证多个asc_copy_l12gm指令的串行化，防止出现异常数据。

调用示例

C++

//待搬运的连续传输数据块为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];
// dst表示目的操作数的起始地址
asc_copy_l12gm(dst, src, n_burst, len_burst, src_gap, dst_gap);