asc_loadalign_deintlv

产品支持情况

产品	是否支持
Ascend 950PR/Ascend 950DT	√

功能说明

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

以float数据类型、Ascend 950PR/Ascend 950DT产品为例，若VL = 256B，则单次操作覆盖64个float元素。调用asc_loadalign_deintlv后，数据从UB到Reg的排布如下图所示。

提示：
使用本接口需要包含头文件reg_load.h。

函数原型

asc_loadalign_deintlv按源地址的寻址方式分为以下三类接口：基址寻址接口、标量偏移寻址接口、地址寄存器偏移寻址接口。支持的数据类型请参见数据类型章节。

基址寻址接口

C++

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

标量偏移寻址接口

源地址通过src + offset计算得到，且计算结果必须满足32B对齐要求。offset的单位为元素个数，实际地址偏移字节数为：offset * sizeof(data_type)。

C++

__simd_callee__ inline void asc_loadalign_deintlv(vector_int8_t& dst0, vector_int8_t& dst1, __ubuf__ int8_t* src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv(vector_uint8_t& dst0, vector_uint8_t& dst1, __ubuf__ uint8_t* src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv(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(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(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(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(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(vector_hifloat8_t& dst0, vector_hifloat8_t& dst1, __ubuf__ hifloat8_t* src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv(vector_int16_t& dst0, vector_int16_t& dst1, __ubuf__ int16_t* src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv(vector_uint16_t& dst0, vector_uint16_t& dst1, __ubuf__ uint16_t* src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv(vector_half& dst0, vector_half& dst1, __ubuf__ half* src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv(vector_bfloat16_t& dst0, vector_bfloat16_t& dst1, __ubuf__ bfloat16_t* src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv(vector_int32_t& dst0, vector_int32_t& dst1, __ubuf__ int32_t* src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv(vector_uint32_t& dst0, vector_uint32_t& dst1, __ubuf__ uint32_t* src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv(vector_float& dst0, vector_float& dst1, __ubuf__ float* src, int32_t offset)
__simd_callee__ inline void asc_loadalign_deintlv(vector_int4x2_t& dst0, vector_int4x2_t& dst1, __ubuf__ int4b_t* src, int32_t offset)

地址寄存器偏移寻址接口

该类接口通过地址寄存器iter_reg offset生成实际访问地址。地址寄存器通常在循环场景中使用，需配合asc_create_iter_reg完成初始化。实际访问地址必须满足32B对齐要求。

C++

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

参数说明

参数名	输入/输出	说明
dst0	输出	第一个目的向量寄存器。
dst1	输出	第二个目的向量寄存器。
src	输入	源数据在UB中的起始地址。对于不同寻址接口，`src`分别表示基址或参与地址计算的基地址。
offset	输入	地址偏移量。对于标量偏移寻址接口，单位为元素个数；对于地址寄存器偏移寻址接口，表示地址寄存器。

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

数据类型

asc_loadalign_deintlv支持的数据类型如下表所示。三类寻址接口均支持表中所列数据类型。

源数据类型`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。
对于标量偏移寻址接口和地址寄存器偏移寻址接口，实际访问地址必须为32B对齐，且访问范围不能超过UB有效地址上界减去2 x VL。
使用地址寄存器偏移寻址接口时，需要先通过asc_create_iter_reg完成地址寄存器初始化。

调用示例

从UB中连续读取以32B对齐地址src为起始位置的float数据。

基址寻址接口

C++

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

标量偏移寻址接口

C++

// 方 式1：通 过offset控 制 偏 移
for (uint16_t i = 0; i < repeat_times; i++) {
    asc_loadalign_deintlv(reg0, reg1, src, i * one_repeat_size);
    ...
}

// 方 式2：通 过src控 制 偏 移
for (uint16_t i = 0; i < repeat_times; i++) {
    asc_loadalign_deintlv(reg0, reg1, src + i * one_repeat_size, 0);
    ...
}

地址寄存器偏移寻址接口

C++

iter_reg addr_reg = asc_create_iter_reg_b32(one_repeat_size);
for (uint16_t i = 0; i < repeat_times; i++) {
    asc_loadalign_deintlv(reg0, reg1, src, addr_reg);
    ...
}

2.3.1.3. LocalTensor和GlobalTensor定 义

2.3.1.3.1. LocalTensor

2.3.1.3.2. GlobalTensor

2.3.1.4. Tensor API基 础 数 据 结 构

2.3.1.4.1. Layout数 据 结 构

2.3.1.4.2. Tensor数 据 结 构

2.3.1.4.3. 工 具 函 数

2.3.1.5. 辅 助 数 据 结 构

2.3.1.5.1. Coordinate

2.3.1.5.2. Layout

2.3.1.5.3. TensorTrait

2.3.1.5.6. TensorDesc

2.3.2.1. 概 览

2.3.3.1. 概 述

2.3.3.2. 矩 阵 计 算 分 形 介 绍

2.3.3.3. 矩 阵 计 算 的 搬 入

2.3.3.3.4. 矩 阵 数 据 搬 入 至L0-Buffer

2.3.3.3.5. 矩 阵 数 据 搬 入 至L1-Buffer

2.3.3.3.6. 辅 助 配 置 接 口

2.3.3.4. Mmad计 算

2.3.3.4.5. 关 键 特 性 说 明

2.3.3.4.6. 寄 存 器 配 置 说 明

2.3.3.5. 矩 阵 计 算 的 搬 出

2.3.3.5.10. L1到GM数 据 搬 运

2.3.3.5.11. 关 键 特 性 说 明

2.3.3.5.12. 寄 存 器 配 置 说 明

2.3.4.1. 概 述

2.3.4.2. 矩 阵 计 算 分 形 介 绍

2.3.4.3. 矩 阵 计 算 的 搬 入

2.3.4.3.3. 矩 阵 数 据 搬 入 至L1 Buffer

2.3.4.3.4. 矩 阵 数 据 搬 入 至L0 Buffer)

2.3.4.4. Mmad计 算

2.3.4.4.2. 关 键 特 性 说 明

2.3.4.4.3. 寄 存 器 配 置 说 明

2.3.4.5. 矩 阵 计 算 的 搬 出

2.3.4.5.4. 关 键 特 性 说 明

2.3.5.2. SIMD计 算 说 明

2.3.5.2.4. 掩 码

2.3.5.3. 数 据 搬 运

2.3.5.3.1. GM与UB数 据 搬 运

2.3.5.3.2. UB与UB数 据 搬 运

2.3.5.4. 基 础 算 术

2.3.5.5. 逻 辑 计 算

2.3.5.6. 复 合 计 算

2.3.5.7. 比 较 与 选 择

2.3.5.8. 类 型 转 换

2.3.5.8.1. 寄 存 器 配 置 说 明

2.3.5.9. 归 约 计 算

2.3.5.9.8. 寄 存 器 辅 助 接 口

2.3.5.10. 数 据 排 布 转 换

2.3.5.11. 数 据 填 充

2.3.5.12. 排 序 组 合（ISASI）

2.3.5.13. 离 散 与 聚 合

2.3.5.14. 掩 码 操 作

2.3.5.15. 数 据 重 排（ISASI）

2.3.6.1. 寄 存 器 数 据 类 型

2.3.6.3. Reg数 据 搬 运

2.3.6.4. MaskReg计 算

2.3.6.5. 基 础 算 术

2.3.6.6. 逻 辑 计 算

2.3.6.7. 复 合 计 算

2.3.6.8. 比 较 与 选 择

2.3.6.9. 类 型 转 换

2.3.6.10. 归 约 计 算

2.3.6.11. 数 据 填 充

2.3.6.12. 离 散 与 聚 合

2.3.6.13. 数 据 重 排

2.3.6.14. 数 据 压 缩

2.3.6.15. 直 方 图 计 算

2.3.6.16. 索 引 操 作

2.3.6.17. 同 步 控 制

2.3.6.18. 系 统 变 量 访 问

2.3.6.19. 数 据 类 型

2.3.8.1. Pipe和Que框 架

2.3.8.1.1. TPipe

2.3.8.1.3. TBufPool

2.3.8.1.4. 自 定 义TBufPool

2.3.8.1.5. TQue

2.3.8.1.6. TSCM

2.3.8.1.7. TQueBind

2.3.1.3. LocalTensor和GlobalTensor定义

2.3.1.4. Tensor API基础数据结构

2.3.1.4.1. Layout数据结构

2.3.1.4.2. Tensor数据结构

2.3.1.4.3. 工具函数

2.3.1.5. 辅助数据结构

2.3.2.1. 概览

2.3.3.1. 概述

2.3.3.2. 矩阵计算分形介绍

2.3.3.3. 矩阵计算的搬入

2.3.3.3.4. 矩阵数据搬入至L0-Buffer

2.3.3.3.5. 矩阵数据搬入至L1-Buffer

2.3.3.3.6. 辅助配置接口

2.3.3.4. Mmad计算

2.3.3.4.5. 关键特性说明

2.3.3.4.6. 寄存器配置说明

2.3.3.5. 矩阵计算的搬出

2.3.3.5.10. L1到GM数据搬运

2.3.3.5.11. 关键特性说明

2.3.3.5.12. 寄存器配置说明

2.3.4.1. 概述

2.3.4.2. 矩阵计算分形介绍

2.3.4.3. 矩阵计算的搬入

2.3.4.3.3. 矩阵数据搬入至L1 Buffer

2.3.4.3.4. 矩阵数据搬入至L0 Buffer)

2.3.4.4. Mmad计算

2.3.4.4.2. 关键特性说明

2.3.4.4.3. 寄存器配置说明

2.3.4.5. 矩阵计算的搬出

2.3.4.5.4. 关键特性说明

2.3.5.2. SIMD计算说明

2.3.5.2.4. 掩码

2.3.5.3. 数据搬运

2.3.5.3.1. GM与UB数据搬运

2.3.5.3.2. UB与UB数据搬运

2.3.5.4. 基础算术

2.3.5.5. 逻辑计算

2.3.5.6. 复合计算

2.3.5.7. 比较与选择

2.3.5.8. 类型转换

2.3.5.8.1. 寄存器配置说明

2.3.5.9. 归约计算

2.3.5.9.8. 寄存器辅助接口

2.3.5.10. 数据排布转换

2.3.5.11. 数据填充

2.3.5.12. 排序组合（ISASI）

2.3.5.13. 离散与聚合

2.3.5.14. 掩码操作

2.3.5.15. 数据重排（ISASI）

2.3.6.1. 寄存器数据类型

2.3.6.3. Reg数据搬运

2.3.6.4. MaskReg计算

2.3.6.5. 基础算术

2.3.6.6. 逻辑计算

2.3.6.7. 复合计算

2.3.6.8. 比较与选择

2.3.6.9. 类型转换

2.3.6.10. 归约计算

2.3.6.11. 数据填充

2.3.6.12. 离散与聚合

2.3.6.13. 数据重排

2.3.6.14. 数据压缩

2.3.6.15. 直方图计算

2.3.6.16. 索引操作

2.3.6.17. 同步控制

2.3.6.18. 系统变量访问

2.3.6.19. 数据类型

2.3.8.1. Pipe和Que框架

2.3.8.1.4. 自定义TBufPool

2.3.8.2. 临时空间管理

2.3.8.3. 内存管理

2.3.9.2. 核内同步

2.3.9.3. 核间同步

2.3.9.4. 任务间同步

2.3.12.1. 上板打印

2.3.12.2. 异常检测

2.3.12.3. CPU孪生调试

2.3.12.4. 性能统计

2.3.13.1. 执行模式

2.3.13.2. 系统初始化