CANN/asc-devkit原子加操作

asc_atomic_add【免费下载链接】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 训练系列产品不支持功能说明对Unified Buffer或Global Memory中的数据与指定数据执行原子加操作即将指定数据累加到这些内存区域的数据中。函数原型inline int32_t asc_atomic_add(int32_t *address, int32_t val)inline uint32_t asc_atomic_add(uint32_t *address, uint32_t val)inline float asc_atomic_add(float *address, float val)inline int64_t asc_atomic_add(int64_t *address, int64_t val)inline uint64_t asc_atomic_add(uint64_t *address, uint64_t val)inline half asc_atomic_add(half *address, half val)inline bfloat16_t asc_atomic_add(bfloat16_t *address, bfloat16_t val)inline half2 asc_atomic_add(half2 *address, half2 val)inline bfloat16x2_t asc_atomic_add(bfloat16x2_t *address, bfloat16x2_t val)参数说明表1参数说明参数名输入/输出描述address输出Unified Buffer或Global Memory的地址。val输入源操作数。不同数据类型支持的内存范围说明如下表2不同数据类型支持的内存范围参数数据类型支持的内存空间int32_t、uint32_t、float、half、bfloat16_t、half2、bfloat16x2_tUnified Buffer、Global Memoryint64_t、uint64_tGlobal Memory返回值说明Unified Buffer或Global Memory上的初始数据。注意由于底层硬件约束half和bfloat16_t类型的返回值不准确避免直接使用这些类型的返回值。约束说明原子操作保证对同一地址的读改写过程具有原子性但不保证多个线程之间的执行顺序。对于浮点累加顺序敏感场景结果可能随线程调度变化而不同。需要包含的头文件使用除half、half2、bfloat16_t、bfloat16x2_t类型之外的接口需要包含simt_api/device_atomic_functions.h头文件使用half和half2类型接口需要包含simt_api/asc_fp16.h头文件使用bfloat16_t和bfloat16x2_t类型接口需要包含simt_api/asc_bf16.h头文件。#include simt_api/device_atomic_functions.h#include simt_api/asc_fp16.h#include simt_api/asc_bf16.h调用示例可参阅字节序频率直方图样例该样例详细展示了如何利用asc_atomic_add接口高效统计输入字节序列中每个字节值的出现频率。简单示例场景多个线程扫描状态数组状态非0表示一条异常记录使用asc_atomic_add接口统计异常状态的数量。输入参数说明如下名称说明status每个元素表示一条状态记录0为正常非0为异常。error_countGlobal Memory中的异常计数器kernel启动前清零。n输入元素个数。核心代码实现如下SIMT编程场景__global__ __launch_bounds__(256) void count_error_status(uint32_t *error_count, uint32_t *status, uint32_t n) { uint32_t idx blockIdx.x * blockDim.x threadIdx.x; if (idx n) { return; } if (status[idx] ! 0U) { asc_atomic_add(error_count, 1U); } }SIMD与SIMT混合编程场景SIMD与SIMT混合编程场景需要显式使用地址空间限定符表示地址空间__gm__表示Global Memory内存空间__ubuf__表示Unified Buffer内存空间。__simt_vf__ __launch_bounds__(1024) inline void count_error_status(__gm__ uint32_t *error_count, __gm__ uint32_t *status, uint32_t n) { uint32_t idx blockIdx.x * blockDim.x threadIdx.x; if (idx n) { return; } if (status[idx] ! 0U) { asc_atomic_add(error_count, 1U); } }输出结果示例如下status: 0, 2, 0, 1, 3 error_count: 3 // 表明status中有3个数据是非0的【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言原生支持C和C标准规范主要由类库和语言扩展层构成提供多层级API满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考