开发者
资源

asc_atomic_inc

产品支持情况

产品

是否支持

Atlas 350 加速卡

Atlas A3 训练系列产品/Atlas A3 推理系列产品

x

Atlas A2 训练系列产品/Atlas A2 推理系列产品

x

Atlas 200I/500 A2 推理产品

x

Atlas 推理系列产品AI Core

x

Atlas 推理系列产品Vector Core

x

Atlas 训练系列产品

x

功能说明

Unified BufferGlobal Memory上address的数值进行原子加1操作,如果address上的数值大于等于指定数值val,则对address赋值为0,否则将address上数值加1。

函数原型

1
inline uint32_t asc_atomic_inc(uint32_t *address, uint32_t val)
1
inline uint64_t asc_atomic_inc(uint64_t *address, uint64_t val)

参数说明

表1 参数说明

参数名

输入/输出

描述

address

输出

Unified BufferGlobal Memory的地址。

val

输入

源操作数。

不同数据类型支持的内存范围说明如下:

表2 不同数据类型支持的内存范围

参数数据类型

支持的内存空间

uint32_t

Unified BufferGlobal Memory

uint64_t

Global Memory

返回值说明

Unified BufferGlobal Memory上的初始数据。

约束说明

SIMT编程场景当前不支持使用该接口。

需要包含的头文件

使用该接口需要包含"simt_api/device_atomic_functions.h"头文件。

1
#include "simt_api/device_atomic_functions.h"

调用示例

SIMD与SIMT混合编程场景:

SIMD与SIMT混合编程场景,需要显式使用地址空间限定符表示地址空间:__gm__表示Global Memory内存空间,__ubuf__表示Unified Buffer内存空间。
1
2
3
4
5
__simt_vf__ __launch_bounds__(1024) inline void KernelAtomicInc(__gm__ uint32_t* dst, __gm__ uint32_t* src)
{
    int idx = threadIdx.x + blockIdx.x * blockDim.x;
    asc_atomic_inc(dst + idx, src[idx]);
}