asc_add_scalar

产品支持情况

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

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

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

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

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

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

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

功能说明

执行矢量加法运算。计算公式如下：

函数原型

• 连续数据计算

C++

__aicore__ inline void asc_add_scalar(__ubuf__ int16_t* dst, __ubuf__ int16_t* src, int16_t value, uint32_t count)
__aicore__ inline void asc_add_scalar(__ubuf__ half* dst, __ubuf__ half* src, half value, uint32_t count)
__aicore__ inline void asc_add_scalar(__ubuf__ int32_t* dst, __ubuf__ int32_t* src, int32_t value, uint32_t count)
__aicore__ inline void asc_add_scalar(__ubuf__ float* dst, __ubuf__ float* src, float value, uint32_t count)

• 高维切分计算

C++

__aicore__ inline void asc_add_scalar(__ubuf__ int16_t* dst, __ubuf__ int16_t* src, int16_t value, uint8_t repeat, 
    uint16_t dst_block_stride, uint16_t src_block_stride, uint16_t dst_repeat_stride, uint16_t src_repeat_stride)
__aicore__ inline void asc_add_scalar(__ubuf__ half* dst, __ubuf__ half* src, half value, uint8_t repeat, 
    uint16_t dst_block_stride, uint16_t src_block_stride, uint16_t dst_repeat_stride, uint16_t src_repeat_stride)
__aicore__ inline void asc_add_scalar(__ubuf__ int32_t* dst, __ubuf__ int32_t* src, int32_t value, uint8_t repeat, 
    uint16_t dst_block_stride, uint16_t src_block_stride, uint16_t dst_repeat_stride, uint16_t src_repeat_stride)
__aicore__ inline void asc_add_scalar(__ubuf__ float* dst, __ubuf__ float* src, float value, uint8_t repeat, 
    uint16_t dst_block_stride, uint16_t src_block_stride, uint16_t dst_repeat_stride, uint16_t src_repeat_stride)

• 同步计算

C++

__aicore__ inline void asc_add_scalar_sync(__ubuf__ int16_t* dst, __ubuf__ int16_t* src, int16_t value, uint32_t count)
__aicore__ inline void asc_add_scalar_sync(__ubuf__ half* dst, __ubuf__ half* src, half value, uint32_t count)
__aicore__ inline void asc_add_scalar_sync(__ubuf__ int32_t* dst, __ubuf__ int32_t* src, int32_t value, uint32_t count)
__aicore__ inline void asc_add_scalar_sync(__ubuf__ float* dst, __ubuf__ float* src, float value, uint32_t count)

参数说明

表1 参数说明

参数名	输入/输出	描述
dst	输出	目的操作数。
src	输入	源操作数（矢量）的起始地址。
value	输入	源操作数（标量）。
repeat	输入	迭代次数。
dst_block_stride	输入	目的操作数单次迭代内不同DataBlock间地址步长。
src_block_stride	输入	源操作数单次迭代内不同DataBlock间地址步长。
dst_repeat_stride	输入	目的操作数相邻迭代间相同DataBlock的地址步长。
src_repeat_stride	输入	源操作数相邻迭代间相同DataBlock的地址步长。
count	输入	参与连续计算的元素个数。

返回值说明

无

流水类型

PIPE_V

约束说明

• 操作数地址重叠约束请参考通用地址重叠约束。
• dst、src的起始地址需要32字节对齐。

调用示例

C++

//total_length指参与计算的数据长度
constexpr uint64_t total_length = 64;
half scalar_val = 0.0f;
__ubuf__ half src[total_length];
__ubuf__ half dst[total_length];
asc_add_scalar(dst, src, scalar_val, total_length);