asc_loadalign_deintlv_postupdate

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

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

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

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

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

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

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

功能说明

asc_loadalign_deintlv_postupdate用于从UB中读取以32B对齐地址src为起始位置的连续2 x VL长度数据。数据按元素类型宽度进行解释，在Load过程中完成解交织后，分别写入两个目的向量寄存器dst0和dst1。

与asc_loadalign_deintlv不同，该接口在完成数据加载后，会对源地址参数src执行后更新操作：

C++

src = src + offset

其中，offset的单位为元素个数，实际地址偏移字节数为：offset * sizeof(data_type)。

以float数据类型、Ascend 950PR/Ascend 950DT产品为例，若VL = 256B、src = 32、offset = 128，调用asc_loadalign_deintlv_postupdate后，数据从UB到Reg的排布如下图所示，同时src会更新为544，可直接用于后续计算。

提示：

1. 使用本接口需要包含头文件reg_load.h。
2. 本接口会修改输入的UB地址参数src。若需要保留原始地址，请使用asc_loadalign_deintlv。

函数原型

支持的数据类型请参见数据类型章节。

C++

__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_int4x2_t& dst0, vector_int4x2_t& dst1, __ubuf__ int4b_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_fp4x2_e2m1_t& dst0, vector_fp4x2_e2m1_t& dst1, __ubuf__ fp4x2_e2m1_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_fp4x2_e1m2_t& dst0, vector_fp4x2_e1m2_t& dst1, __ubuf__ fp4x2_e1m2_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_int8_t& dst0, vector_int8_t& dst1, __ubuf__ int8_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_uint8_t& dst0, vector_uint8_t& dst1, __ubuf__ uint8_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_fp8_e8m0_t& dst0, vector_fp8_e8m0_t& dst1, __ubuf__ fp8_e8m0_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_fp8_e5m2_t& dst0, vector_fp8_e5m2_t& dst1, __ubuf__ fp8_e5m2_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_fp8_e4m3fn_t& dst0, vector_fp8_e4m3fn_t& dst1, __ubuf__ fp8_e4m3fn_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_hifloat8_t& dst0, vector_hifloat8_t& dst1, __ubuf__ hifloat8_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_int16_t& dst0, vector_int16_t& dst1, __ubuf__ int16_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_uint16_t& dst0, vector_uint16_t& dst1, __ubuf__ uint16_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_half& dst0, vector_half& dst1, __ubuf__ half*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_bfloat16_t& dst0, vector_bfloat16_t& dst1, __ubuf__ bfloat16_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_int32_t& dst0, vector_int32_t& dst1, __ubuf__ int32_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_uint32_t& dst0, vector_uint32_t& dst1, __ubuf__ uint32_t*& src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv_postupdate(vector_float& dst0, vector_float& dst1, __ubuf__ float*& src, int32_t offset)

参数说明

表1 参数说明

参数名	输入/输出	说明
dst0	输出	第一个目的向量寄存器。
dst1	输出	第二个目的向量寄存器。
src	输入/输出	源数据在UB中的起始地址，要求32B对齐。接口执行完成后，src会更新为src + offset。
offset	输入	地址偏移量，单位为元素个数。

向量寄存器类型的详细说明请参见reg数据类型定义。

数据类型

asc_loadalign_deintlv_postupdate支持的数据类型如下表所示。

表2 数据类型

源数据类型src	目的寄存器类型dst0/dst1
int4b_t	vector_int4x2_t
fp4x2_e1m2_t	vector_fp4x2_e1m2_t
fp4x2_e2m1_t	vector_fp4x2_e2m1_t
int8_t	vector_int8_t
uint8_t	vector_uint8_t
fp8_e4m3fn_t	vector_fp8_e4m3fn_t
fp8_e5m2_t	vector_fp8_e5m2_t
fp8_e8m0_t	vector_fp8_e8m0_t
hifloat8_t	vector_hifloat8_t
int16_t	vector_int16_t
uint16_t	vector_uint16_t
half	vector_half
bfloat16_t	vector_bfloat16_t
int32_t	vector_int32_t
uint32_t	vector_uint32_t
float	vector_float

返回值说明

无。

流水类型

PIPE_V

约束说明

• src必须为32B对齐地址，且访问范围不能超过UB有效地址上界减去2 x VL，否则可能导致UB越界访问。
• 在循环中使用本接口时，offset的取值需要保证更新后的src仍满足32B对齐要求。
• offset以元素为单位，实际地址步长需要结合源数据类型宽度进行换算。

调用示例

从UB中连续读取以32B对齐地址src为起始位置的float数据，并在每次调用后自动更新地址。

C++

for (uint16_t i = 0; i < repeat_times; i++) {
    asc_loadalign_deintlv_postupdate(reg0, reg1, src, one_repeat_size);
    ...
}