asc_set_gm2ub_loop1_stride

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

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

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

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

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

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

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

功能说明

将数据从Global Memory (GM)搬运到Unified Buffer (UB)时，通过调用该接口设置内层循环中相邻迭代数据块间的间隔。

以源操作数搬运场景为例，如下图所示。

函数原型

C++

__aicore__ inline void asc_set_gm2ub_loop1_stride(uint64_t loop1_src_stride, uint64_t loop1_dst_stride)

参数说明

表1 参数说明

参数名	输入/输出	描述
loop1_src_stride	输入	内层循环中相邻迭代源操作数的数据块间的间隔，单位为Byte，取值范围为[0, 2^40)。
loop1_dst_stride	输入	内层循环中相邻迭代目标操作数的数据块间的间隔，单位为Byte，取值范围为[0, 2^21)，且必须32B对齐。

返回值说明

无

流水类型

PIPE_S

约束说明

每次设置循环相关参数后，需要进行寄存器的复位（循环次数设置为1），否则会影响下一次搬运的使用。

调用示例

C++

asc_set_gm2ub_loop_size(2, 2);
asc_set_gm2ub_loop1_stride(96, 128);
asc_set_gm2ub_loop2_stride(192, 288);
asc_copy_gm2ub_align(dst, src, 2, 48 * sizeof(int8_t), 0, 0, false, asc_load_l2_cache_mode::NORMAL_FIRST_VICTIM, 48, 48);
asc_set_gm2ub_loop_size(1, 1);