CANN/asc-devkit线程数据交换函数

asc_shfl

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

产品支持情况

功能说明

获取Warp内指定线程src_lane输入的用于交换的var值；如果目标线程是非活跃状态，获取到寄存器中未初始化的值。其中，参数width用于划分Warp内线程的分组。参数width设置参与交换的32个线程的分组宽度，默认值为32，即所有线程分为1组。

在多个分组场景（width小于32）下，每个分组交换操作是独立的，当前线程获取本组内线程编号为src_lane的var值。如果src_lane小于分组宽度width，src_lane是相对组内起始线程位置的逻辑LaneId；如果src_lane大于等于width，src_lane%width的结果是相对组内起始线程位置的逻辑LaneId。

例如，Warp内32个活跃线程调用asc_shfl(LaneId, 1, 16)接口，每个线程的返回值为当前线程所在分组内线程编号为1的var值。

图 1 asc_shfl结果示意图
![](https://raw.gitcode.com/cann/asc-devkit/raw/f35dfef9af78af31a0418d6061f7969c5ffc6990/docs/api/context/figures/asc_shfl结果示意图.png "asc_shfl结果示意图"?utm_source=gitcode_repo_files)

函数原型

__simt_callee__ inline int32_t asc_shfl(int32_t var, int32_t src_lane, int32_t width = warpSize)

__simt_callee__ inline uint32_t asc_shfl(uint32_t var, int32_t src_lane, int32_t width = warpSize)

__simt_callee__ inline float asc_shfl(float var, int32_t src_lane, int32_t width = warpSize)

__simt_callee__ inline int64_t asc_shfl(int64_t var, int32_t src_lane, int32_t width = warpSize)

__simt_callee__ inline uint64_t asc_shfl(uint64_t var, int32_t src_lane, int32_t width = warpSize)

__simt_callee__ inline half asc_shfl(half var, int32_t src_lane, int32_t width = warpSize)

__simt_callee__ inline half2 asc_shfl(half2 var, int32_t src_lane, int32_t width = warpSize)

参数说明

表 1 参数说明

返回值说明

• Warp内指定线程的var值
• 未初始化undefined的值

约束说明

无

需要包含的头文件

使用除half、half2类型之外的接口需要包含"simt_api/device_warp_functions.h"头文件，使用half和half2类型接口需要包含"simt_api/asc_fp16.h"头文件。

#include "simt_api/device_warp_functions.h" 

#include "simt_api/asc_fp16.h"

调用示例

__simt_vf__ __launch_bounds__(1024) inline void KernelShfl(__gm__ int32_t* dst)
{
    // asc_vf_call参数：dim3{1024, 1, 1}
    int idx = threadIdx.x + blockIdx.x * blockDim.x;
    int32_t laneId = idx % 32;
    // 0-15线程返回值为1，16-31线程返回值为17
    int32_t result = asc_shfl(laneId, 1, 16);
    dst[idx] = result;
}

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